feat: add db:seed command to package.json and update README.md for seeding reference data. Enhance job status handling in generation logic to support completed_partial status, improving error reporting and user feedback. Introduce new utility functions for job outcome resolution and non-retryable error detection, along with corresponding tests. Update database migration scripts to include new tables and fields for improved data management.

README.md

@@ -151,7 +151,7 @@ bun run db:push
 Optionally seed reference data (exam types, sections):
 
 ```bash
-cd packages/db && bun run db:seed
+bun run db:seed
 ```
 
 ### 5. Run the dev servers
@@ -218,6 +218,7 @@ Run from the **repository root**:
 | `bun run db:push` | Push Drizzle schema to PostgreSQL |
 | `bun run db:generate` | Generate migration files |
 | `bun run db:migrate` | Run migrations |
+| `bun run db:seed` | Seed reference data (exam types, sections) |
 | `bun run db:studio` | Open Drizzle Studio |
 | `bun run db:start` | Start PostgreSQL + Redis (Docker Compose) |
 | `bun run db:stop` | Stop Docker Compose services |

apps/web/src/components/generate/GlobalGenerationProgress.tsx

@@ -4,6 +4,7 @@ import { useMutation } from "@tanstack/react-query";
 import { Button } from "@labas/ui/components/button";
 import { MaterialIcon } from "@/components/ui/MaterialIcon";
 import { useGenerationJobs, type ActiveJob } from "@/hooks/use-generation-jobs";
+import { isTerminal } from "@/hooks/use-job-shared";
 import { trpc, queryClient } from "@/utils/trpc";
 
 interface LogEntry {
@@ -196,7 +197,7 @@ function SingleJobCard({
         </div>
       </div>
 
-      {isAgentic && <TerminalLog logs={logs} isRunning={job.status !== "completed"} />}
+      {isAgentic && <TerminalLog logs={logs} isRunning={!isTerminal(job.status)} />}
     </div>
   );
 }

apps/web/src/hooks/use-generation-jobs.ts

@@ -75,9 +75,12 @@ export function useGenerationJobs() {
     );
 
     if (alreadyCompleted) {
-      if (status === "completed" && data.resultJson) {
+      if ((status === "completed" || status === "completed_partial") && data.resultJson) {
         setResult(baseResult);
       }
+      if (status === "completed_partial" && data.errorMessage) {
+        setError(data.errorMessage as string);
+      }
       return;
     }
 
@@ -87,6 +90,13 @@ export function useGenerationJobs() {
       }
     }
 
+    if (status === "completed_partial" && data.resultJson) {
+      setResult(baseResult);
+      if (data.errorMessage) {
+        setError(data.errorMessage as string);
+      }
+    }
+
     if (status === "completed" && data.resultJson) {
       setResult(baseResult);
     }

apps/web/src/hooks/use-job-shared.ts

@@ -59,7 +59,7 @@ export const ACTIVE_STATUSES = new Set([
   "running_quality",
 ]);
 
-export const TERMINAL_STATUSES = new Set(["completed", "failed", "cancelled"]);
+export const TERMINAL_STATUSES = new Set(["completed", "completed_partial", "failed", "cancelled"]);
 
 export function isTerminal(status: string): boolean {
   return TERMINAL_STATUSES.has(status);

apps/web/src/routes/__root.tsx

@@ -94,12 +94,12 @@ function RootComponent() {
         <GlobalGenerationProgress />
         <Toaster richColors />
       </ThemeProvider>
-      {/* {import.meta.env.DEV && (
+      {import.meta.env.DEV && (
         <>
           <TanStackRouterDevtools position="bottom-left" />
           <ReactQueryDevtools position="bottom" buttonPosition="bottom-right" />
         </>
-      )} */}
+      )}
     </>
   );
 }

apps/web/src/routes/admin.jobs.tsx

@@ -8,7 +8,7 @@ import { getErrorMessage } from "@/lib/error-utils";
 import { DataTable } from "@/components/admin/DataTable";
 import type { ColumnDef } from "@/components/admin/DataTable";
 
-const STATUSES = ["all", "pending", "running", "completed", "failed", "cancelled"] as const;
+const STATUSES = ["all", "pending", "running", "completed", "completed_partial", "failed", "cancelled"] as const;
 
 export const Route = createFileRoute("/admin/jobs")({
   component: AdminJobs,
@@ -87,6 +87,7 @@ function AdminJobs() {
       cell: ({ row }) => (
         <span className={`text-xs font-semibold px-2 py-0.5 rounded-full ${
           row.status === "completed" ? "bg-[var(--matcha-300)] text-[var(--matcha-800)]" :
+          row.status === "completed_partial" ? "bg-[var(--pomegranate-400)]/10 text-[var(--pomegranate-400)]" :
           row.status === "failed" ? "bg-[var(--clay-red)]/10 text-[var(--clay-red)]" :
           row.status === "cancelled" ? "bg-[var(--oat-border)] text-[var(--warm-charcoal)]" :
           row.status === "running" ? "bg-[var(--sunbeam-300)] text-[var(--sunbeam-800)]" :

apps/web/src/routes/jobs.tsx

@@ -118,6 +118,7 @@ const STATUS_COLORS: Record<string, string> = {
   partial_ready: "bg-[var(--lemon-300)] text-[var(--lemon-800)]",
   running_quality: "bg-[var(--matcha-300)] text-[var(--matcha-800)]",
   completed: "bg-[var(--lemon-300)] text-[var(--lemon-800)]",
+  completed_partial: "bg-[var(--pomegranate-400)]/20 text-[var(--pomegranate-400)]",
   failed: "bg-[var(--pomegranate-400)]/20 text-[var(--pomegranate-400)]",
   cancelled: "bg-[var(--warm-silver)] text-[var(--warm-charcoal)]",
 };
@@ -129,6 +130,7 @@ const STATUS_ICONS: Record<string, string> = {
   partial_ready: "auto_awesome",
   running_quality: "tune",
   completed: "check_circle",
+  completed_partial: "warning",
   failed: "error",
   cancelled: "block",
 };
@@ -330,8 +332,13 @@ function RouteComponent() {
                   )}
                 </CardHeader>
 
-                {job.status === "completed" && result && (
+                {(job.status === "completed" || job.status === "completed_partial") && result && (
                   <CardContent className="pt-0">
+                    {job.status === "completed_partial" && job.errorMessage && (
+                      <div className="mb-3 p-3 rounded-[var(--radius-md)] bg-[var(--pomegranate-400)]/10 border border-[var(--pomegranate-400)]/20 text-sm text-[var(--pomegranate-400)]">
+                        {job.errorMessage}
+                      </div>
+                    )}
                     <div className="flex items-center justify-between mb-3">
                       <div className="text-sm text-[var(--warm-charcoal)]">
                         {(() => {

deploy/COOLIFY.md

@@ -155,7 +155,7 @@ Alternative for local-style sync (not recommended in production): `bun run db:pu
 Optional seed (run once via **Terminal** on the server app):
 
 ```bash
-cd packages/db && bun run db:seed
+bun run db:seed
 ```
 
 ### Verify

package.json

@@ -31,6 +31,7 @@
     "db:studio": "turbo -F @labas/db db:studio",
     "db:generate": "turbo -F @labas/db db:generate",
     "db:migrate": "turbo -F @labas/db db:migrate",
+    "db:seed": "turbo -F @labas/db db:seed",
     "db:start": "turbo -F @labas/db db:start",
     "db:watch": "turbo -F @labas/db db:watch",
     "db:stop": "turbo -F @labas/db db:stop",

packages/api/src/__tests__/generation-outcome.test.ts

@@ -0,0 +1,73 @@
+import { describe, expect, it } from "bun:test";
+import {
+  isNonRetryableProviderError,
+  resolveGenerationJobOutcome,
+  sectionsWithNoQuestions,
+} from "../lib/generation-outcome";
+
+describe("isNonRetryableProviderError", () => {
+  it("detects OpenAI-compatible 500 errors", () => {
+    expect(
+      isNonRetryableProviderError(
+        new Error('OpenAI-compatible API error 500: {"error":{"message":"litellm.MidStreamFallbackError"}}'),
+      ),
+    ).toBe(true);
+  });
+
+  it("detects LiteLLM connection errors", () => {
+    expect(isNonRetryableProviderError(new Error("litellm.APIConnectionError: upstream failed"))).toBe(
+      true,
+    );
+  });
+
+  it("returns false for JSON parse failures", () => {
+    expect(isNonRetryableProviderError(new Error("Failed to parse AI response as JSON"))).toBe(false);
+  });
+});
+
+describe("resolveGenerationJobOutcome", () => {
+  it("marks full success as completed", () => {
+    expect(
+      resolveGenerationJobOutcome({ requestedCount: 20, generatedCount: 20 }),
+    ).toEqual({
+      status: "completed",
+      progressMessage: "Completed",
+      errorMessage: null,
+    });
+  });
+
+  it("marks partial success as completed_partial", () => {
+    const outcome = resolveGenerationJobOutcome({
+      requestedCount: 20,
+      generatedCount: 4,
+      failedSections: ["WRITING"],
+    });
+    expect(outcome.status).toBe("completed_partial");
+    expect(outcome.errorMessage).toContain("4 dari 20");
+    expect(outcome.errorMessage).toContain("WRITING");
+  });
+
+  it("marks zero questions as failed", () => {
+    const outcome = resolveGenerationJobOutcome({
+      requestedCount: 20,
+      generatedCount: 0,
+      failedSections: ["READING", "WRITING"],
+    });
+    expect(outcome.status).toBe("failed");
+    expect(outcome.errorMessage).toContain("Tidak ada soal");
+  });
+});
+
+describe("sectionsWithNoQuestions", () => {
+  it("returns sections missing from generated questions", () => {
+    expect(
+      sectionsWithNoQuestions(
+        [
+          { section: "READING", count: 10 },
+          { section: "WRITING", count: 10 },
+        ],
+        [{ section: "READING" }, { section: "READING" }],
+      ),
+    ).toEqual(["WRITING"]);
+  });
+});

packages/api/src/lib/generation-outcome.ts

@@ -0,0 +1,60 @@
+export function isNonRetryableProviderError(error: unknown): boolean {
+  const message = error instanceof Error ? error.message : String(error);
+  const lower = message.toLowerCase();
+
+  if (/openai-compatible api error 5\d\d/i.test(message)) return true;
+  if (/api error 5\d\d/i.test(message)) return true;
+  if (lower.includes("midstreamfallbackerror")) return true;
+  if (lower.includes("apiconnectionerror")) return true;
+  if (lower.includes("provider returned html")) return true;
+  if (/\berror 502\b/.test(lower) || /\berror 503\b/.test(lower) || /\berror 504\b/.test(lower)) {
+    return true;
+  }
+
+  return false;
+}
+
+export function resolveGenerationJobOutcome(input: {
+  requestedCount: number;
+  generatedCount: number;
+  failedSections?: string[];
+}): {
+  status: "completed" | "completed_partial" | "failed";
+  progressMessage: string;
+  errorMessage: string | null;
+} {
+  const failedSections = [...new Set(input.failedSections ?? [])];
+  const sectionHint =
+    failedSections.length > 0 ? ` Section gagal: ${failedSections.join(", ")}.` : "";
+
+  if (input.generatedCount <= 0) {
+    return {
+      status: "failed",
+      progressMessage: "Generation failed",
+      errorMessage: `Tidak ada soal yang berhasil dibuat.${sectionHint} Periksa model/API provider.`,
+    };
+  }
+
+  if (input.generatedCount < input.requestedCount) {
+    return {
+      status: "completed_partial",
+      progressMessage: `Selesai sebagian: ${input.generatedCount}/${input.requestedCount} soal`,
+      errorMessage: `Hanya ${input.generatedCount} dari ${input.requestedCount} soal berhasil dibuat.${sectionHint}`,
+    };
+  }
+
+  return {
+    status: "completed",
+    progressMessage: "Completed",
+    errorMessage: null,
+  };
+}
+
+export function sectionsWithNoQuestions(
+  sectionSplits: Array<{ section: string; count: number }>,
+  questions: Array<{ section: string }>,
+): string[] {
+  return sectionSplits
+    .filter((split) => !questions.some((q) => q.section === split.section))
+    .map((split) => split.section);
+}

packages/api/src/queue.ts

@@ -26,6 +26,11 @@ import {
 } from "@labas/db";
 import { and, eq, notInArray } from "drizzle-orm";
 import { encryptApiKey, decryptApiKey } from "./lib/encryption";
+import {
+  isNonRetryableProviderError,
+  resolveGenerationJobOutcome,
+  sectionsWithNoQuestions,
+} from "./lib/generation-outcome";
 
 const connectionOptions = { maxRetriesPerRequest: null };
 const FAST_QUEUE_NAME = "generation-fast";
@@ -359,15 +364,17 @@ async function saveGeneratedArtifacts(
         .returning();
 
       if (sec) {
-        await db.insert(sectionQuestion).values(
-          sectionQuestions
-            .map((q, idx) => ({
-              sectionId: sec.id,
-              questionId: savedQuestionIds[q._globalIndex],
-              orderIndex: idx,
-            }))
-            .filter((q) => q.questionId != null) as any,
-        );
+        const sectionQuestionRows = sectionQuestions
+          .map((q, idx) => ({
+            sectionId: sec.id,
+            questionId: savedQuestionIds[q._globalIndex],
+            orderIndex: idx,
+          }))
+          .filter((q) => q.questionId != null);
+
+        if (sectionQuestionRows.length > 0) {
+          await db.insert(sectionQuestion).values(sectionQuestionRows as any);
+        }
       }
     }
   } catch (packageErr: any) {
@@ -383,10 +390,36 @@ async function saveGeneratedArtifacts(
   return { savedQuestionIds, generatedPackageId };
 }
 
+function shardKey(shard: ShardPlan): string {
+  return `${shard.sectionIndex}:${shard.shardIndex}`;
+}
+
+async function failGenerationJob(params: {
+  jobId: string;
+  errorMessage: string;
+  tokensUsed?: number;
+  durationMs: number;
+}) {
+  await db
+    .update(generationJob)
+    .set({
+      status: "failed",
+      progress: 100,
+      progressMessage: "Generation failed",
+      errorMessage: params.errorMessage,
+      tokensUsed: params.tokensUsed,
+      durationMs: params.durationMs,
+      completedAt: new Date(),
+    })
+    .where(eq(generationJob.id, params.jobId));
+}
+
 async function completeJobWithResult(params: {
   jobId: string;
   input: GenerationInput;
+  status?: "completed" | "completed_partial";
   statusMessage?: string;
+  errorMessage?: string | null;
   allQuestions: PersistableQuestion[];
   sectionSplits: SectionSplit[];
   totalTokens: number;
@@ -420,9 +453,10 @@ async function completeJobWithResult(params: {
   await db
     .update(generationJob)
     .set({
-      status: "completed",
+      status: params.status ?? "completed",
       progress: 100,
       progressMessage: params.statusMessage ?? "Completed",
+      errorMessage: params.errorMessage ?? null,
       resultJson: {
         ...result,
         savedQuestionIds,
@@ -430,6 +464,8 @@ async function completeJobWithResult(params: {
         sectionSplits: params.sectionSplits,
         qualityPhase: "final",
         metrics: params.metrics,
+        isPartial: params.status === "completed_partial",
+        requestedQuestionCount: params.input.questionCount,
       } as any,
       tokensUsed: params.totalTokens,
       durationMs: params.durationMs,
@@ -489,7 +525,7 @@ export async function cancelGenerationJob(
 
   if (!row) return { ok: false, reason: "not_found" };
   if (row.userId !== userId) return { ok: false, reason: "forbidden" };
-  if (row.status === "completed" || row.status === "failed" || row.status === "cancelled") {
+  if (row.status === "completed" || row.status === "completed_partial" || row.status === "failed" || row.status === "cancelled") {
     return { ok: false, reason: "not_cancellable" };
   }
 
@@ -535,7 +571,8 @@ export const generationWorker = new Worker<FastJobData>(
     if (
       !initialRow ||
       initialRow.status === "cancelled" ||
-      initialRow.status === "completed"
+      initialRow.status === "completed" ||
+      initialRow.status === "completed_partial"
     ) {
       return;
     }
@@ -546,7 +583,7 @@ export const generationWorker = new Worker<FastJobData>(
       .where(
         and(
           eq(generationJob.id, jobId),
-          notInArray(generationJob.status, ["cancelled", "completed"]),
+          notInArray(generationJob.status, ["cancelled", "completed", "completed_partial"]),
         ),
       )
       .returning({ id: generationJob.id });
@@ -827,24 +864,50 @@ export const generationWorker = new Worker<FastJobData>(
       };
 
       const failedShards: ShardPlan[] = [];
+      const shardFailureInfo = new Map<string, { error: string; nonRetryable: boolean }>();
       await runWithConcurrency(shards, FAST_SHARD_CONCURRENCY, async (shard) => {
         try {
           await runShard(shard);
-        } catch {
-          log("warn", "[GENERATION] Fast shard failed.", { jobId, section: shard.section });
+        } catch (err: any) {
+          const message = err?.message ?? String(err);
+          shardFailureInfo.set(shardKey(shard), {
+            error: message,
+            nonRetryable: isNonRetryableProviderError(err),
+          });
+          log("warn", "[GENERATION] Fast shard failed.", {
+            jobId,
+            section: shard.section,
+            nonRetryable: isNonRetryableProviderError(err),
+          });
           failedShards.push(shard);
         }
       });
 
       if (failedShards.length > 0) {
-        await pushLog(
-          "retry_budget",
-          `Retrying ${failedShards.length} failed shard(s), budget=${MAX_SHARD_RETRIES}`,
-          "running",
-        );
+        const retryableCount = failedShards.filter(
+          (shard) => !shardFailureInfo.get(shardKey(shard))?.nonRetryable,
+        ).length;
+        if (retryableCount > 0) {
+          await pushLog(
+            "retry_budget",
+            `Retrying ${retryableCount} failed shard(s), budget=${MAX_SHARD_RETRIES}`,
+            "running",
+          );
+        }
       }
 
       for (const failedShard of failedShards) {
+        const failure = shardFailureInfo.get(shardKey(failedShard));
+        if (failure?.nonRetryable) {
+          await pushLog(
+            "retry_budget",
+            `[${failedShard.section}] provider error — skipping retries`,
+            "error",
+            failure.error.slice(0, 300),
+          );
+          continue;
+        }
+
         let success = false;
         for (let attempt = 1; attempt <= MAX_SHARD_RETRIES; attempt++) {
           try {
@@ -852,14 +915,24 @@ export const generationWorker = new Worker<FastJobData>(
             success = true;
             break;
           } catch (retryErr: any) {
+            const retryMessage = retryErr?.message ?? String(retryErr);
+            if (isNonRetryableProviderError(retryErr)) {
+              await pushLog(
+                "retry_budget",
+                `[${failedShard.section}] provider error — stopping retries`,
+                "error",
+                retryMessage.slice(0, 300),
+              );
+              break;
+            }
             await pushLog(
               "retry_budget",
-              `[${failedShard.section}] shard retry ${attempt}/${MAX_SHARD_RETRIES} failed: ${retryErr?.message ?? String(retryErr)}`,
+              `[${failedShard.section}] shard retry ${attempt}/${MAX_SHARD_RETRIES} failed: ${retryMessage}`,
               "error",
             );
           }
         }
-        if (!success) {
+        if (!success && !failure?.nonRetryable) {
           await pushLog(
             "retry_budget",
             `[${failedShard.section}] exhausted retry budget`,
@@ -878,59 +951,66 @@ export const generationWorker = new Worker<FastJobData>(
         .flatMap((r) => r.questions)
         .slice(0, input.questionCount);
 
-      if (allQuestions.length === 0) {
-        throw new Error("No questions generated in fast phase");
-      }
-
-      const fastResult: GenerationResult = {
-        questions: allQuestions as any,
-        meta: {
-          model: input.apiKeyConfig.model,
-          tokensUsed: totalTokens || approxTokens,
-          durationMs: totalDurationMs || Date.now() - start,
-          mode: input.mode,
-        },
-      };
+      const outcome = resolveGenerationJobOutcome({
+        requestedCount: input.questionCount,
+        generatedCount: allQuestions.length,
+        failedSections: sectionsWithNoQuestions(sectionSplits, allQuestions),
+      });
 
-      if (selectedMode === "agentic") {
-        await pushLog("save", "Saving agentic result...", "running");
-        await completeJobWithResult({
+      if (outcome.status === "failed") {
+        await pushLog("save", outcome.errorMessage ?? "Generation failed", "error");
+        await failGenerationJob({
           jobId,
-          input,
-          allQuestions,
-          sectionSplits,
-          totalTokens: totalTokens || approxTokens,
+          errorMessage: outcome.errorMessage ?? "Generation failed",
+          tokensUsed: totalTokens || approxTokens || undefined,
           durationMs: Date.now() - start,
-          statusMessage: "Completed",
-          metrics: {
-            timeToFirstValidQuestionMs: timeToFirstValidQuestionMs ?? Date.now() - start,
-            shardCount: shards.length,
-            shardRetryBudget: MAX_SHARD_RETRIES,
-            shardFailures: failedShards.length,
-            singlePassAgentic: true,
-          },
         });
-        await pushLog("save", `Saved ${allQuestions.length} questions`, "done");
         return;
       }
 
-      await pushLog("save", "Saving quick result...", "running");
-      await completeJobWithResult({
+      const finalizeParams = {
         jobId,
         input,
         allQuestions,
         sectionSplits,
         totalTokens: totalTokens || approxTokens,
         durationMs: Date.now() - start,
-        statusMessage: "Completed",
+        status: outcome.status,
+        statusMessage: outcome.progressMessage,
+        errorMessage: outcome.errorMessage,
         metrics: {
           timeToFirstValidQuestionMs: timeToFirstValidQuestionMs ?? Date.now() - start,
           shardCount: shards.length,
           shardRetryBudget: MAX_SHARD_RETRIES,
           shardFailures: failedShards.length,
+          requestedQuestionCount: input.questionCount,
+          generatedQuestionCount: allQuestions.length,
+          ...(selectedMode === "agentic" ? { singlePassAgentic: true } : {}),
         },
-      });
-      await pushLog("save", `Saved ${allQuestions.length} questions`, "done");
+      };
+
+      if (selectedMode === "agentic") {
+        await pushLog("save", "Saving agentic result...", "running");
+        await completeJobWithResult(finalizeParams);
+        await pushLog(
+          "save",
+          outcome.status === "completed_partial"
+            ? `Saved ${allQuestions.length}/${input.questionCount} questions (partial)`
+            : `Saved ${allQuestions.length} questions`,
+          outcome.status === "completed_partial" ? "error" : "done",
+        );
+        return;
+      }
+
+      await pushLog("save", "Saving quick result...", "running");
+      await completeJobWithResult(finalizeParams);
+      await pushLog(
+        "save",
+        outcome.status === "completed_partial"
+          ? `Saved ${allQuestions.length}/${input.questionCount} questions (partial)`
+          : `Saved ${allQuestions.length} questions`,
+        outcome.status === "completed_partial" ? "error" : "done",
+      );
     } catch (err: any) {
       if (
         err instanceof GenerationJobCancelledError ||
@@ -962,7 +1042,7 @@ export const generationWorker = new Worker<FastJobData>(
           completedAt: new Date(),
         })
         .where(eq(generationJob.id, jobId));
-      throw err;
+      return;
     } finally {
       stopHeartbeat();
       cancelPoll.stop();
@@ -989,7 +1069,8 @@ export const generationQualityWorker = new Worker<QualityJobData>(
     if (
       !initialRow ||
       initialRow.status === "cancelled" ||
-      initialRow.status === "completed"
+      initialRow.status === "completed" ||
+      initialRow.status === "completed_partial"
     ) {
       return;
     }
@@ -1178,7 +1259,7 @@ export const generationQualityWorker = new Worker<QualityJobData>(
           completedAt: new Date(),
         })
         .where(eq(generationJob.id, jobId));
-      throw err;
+      return;
     } finally {
       cancelPoll.stop();
     }
@@ -1224,11 +1305,7 @@ export async function enqueueGeneration(
       jobId: jobRecord.id,
       removeOnComplete: { count: 100 },
       removeOnFail: { count: 100 },
-      attempts: 3,
-      backoff: {
-        type: "exponential",
-        delay: 5000,
-      },
+      attempts: 1,
     },
   );
 

packages/db/drizzle.config.ts

@@ -1,28 +1,12 @@
-import { existsSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import dotenv from "dotenv";
 import { defineConfig } from "drizzle-kit";
 
-const serverEnvPath = resolve(dirname(fileURLToPath(import.meta.url)), "../../apps/server/.env");
-
-// Coolify/production inject DATABASE_URL via process.env; .env file is local-dev only.
-if (!process.env.DATABASE_URL && existsSync(serverEnvPath)) {
-  dotenv.config({ path: serverEnvPath });
-}
-
-const databaseUrl = process.env.DATABASE_URL;
-if (!databaseUrl) {
-  throw new Error(
-    "DATABASE_URL is not set. Add it to Coolify environment variables (or apps/server/.env for local dev).",
-  );
-}
+import { loadDatabaseUrl } from "./src/database-url";
 
 export default defineConfig({
   schema: "./src/schema",
   out: "./src/migrations",
   dialect: "postgresql",
   dbCredentials: {
-    url: databaseUrl,
+    url: loadDatabaseUrl(),
   },
 });

packages/db/src/database-url.ts

@@ -0,0 +1,21 @@
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import dotenv from "dotenv";
+
+const serverEnvPath = resolve(dirname(fileURLToPath(import.meta.url)), "../../../apps/server/.env");
+
+export function loadDatabaseUrl(): string {
+  if (!process.env.DATABASE_URL && existsSync(serverEnvPath)) {
+    dotenv.config({ path: serverEnvPath });
+  }
+
+  const databaseUrl = process.env.DATABASE_URL;
+  if (!databaseUrl) {
+    throw new Error(
+      "DATABASE_URL is not set. Add it to Coolify environment variables (or apps/server/.env for local dev).",
+    );
+  }
+
+  return databaseUrl;
+}

packages/db/src/migrations/0004_left_diamondback.sql

@@ -0,0 +1,67 @@
+CREATE TABLE IF NOT EXISTS "admin_audit_log" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"admin_user_id" text NOT NULL,
+	"action" text NOT NULL,
+	"target_user_id" text,
+	"details" jsonb,
+	"created_at" timestamp DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS "credit_transaction" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"user_id" text NOT NULL,
+	"amount" integer NOT NULL,
+	"type" text NOT NULL,
+	"description" text,
+	"tokens_used" integer,
+	"created_at" timestamp DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS "platform_config" (
+	"key" text PRIMARY KEY NOT NULL,
+	"value" text NOT NULL,
+	"updated_at" timestamp DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS "user_credit" (
+	"user_id" text PRIMARY KEY NOT NULL,
+	"token_balance" integer DEFAULT 0 NOT NULL,
+	"lifetime_tokens_used" integer DEFAULT 0 NOT NULL,
+	"created_at" timestamp DEFAULT now() NOT NULL,
+	"updated_at" timestamp DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+ALTER TABLE "answer" ADD COLUMN IF NOT EXISTS "partial_score" integer;--> statement-breakpoint
+ALTER TABLE "generation_job" ADD COLUMN IF NOT EXISTS "input_json" jsonb;--> statement-breakpoint
+ALTER TABLE "question" ADD COLUMN IF NOT EXISTS "is_case_sensitive" boolean DEFAULT false NOT NULL;--> statement-breakpoint
+ALTER TABLE "question" ADD COLUMN IF NOT EXISTS "is_featured" boolean DEFAULT false NOT NULL;--> statement-breakpoint
+ALTER TABLE "user" ADD COLUMN IF NOT EXISTS "role" text DEFAULT 'user' NOT NULL;--> statement-breakpoint
+ALTER TABLE "user" ADD COLUMN IF NOT EXISTS "suspended" boolean DEFAULT false NOT NULL;--> statement-breakpoint
+DO $$ BEGIN
+ ALTER TABLE "admin_audit_log" ADD CONSTRAINT "admin_audit_log_admin_user_id_user_id_fk" FOREIGN KEY ("admin_user_id") REFERENCES "public"."user"("id") ON DELETE cascade ON UPDATE no action;
+EXCEPTION
+ WHEN duplicate_object THEN null;
+END $$;
+--> statement-breakpoint
+DO $$ BEGIN
+ ALTER TABLE "admin_audit_log" ADD CONSTRAINT "admin_audit_log_target_user_id_user_id_fk" FOREIGN KEY ("target_user_id") REFERENCES "public"."user"("id") ON DELETE set null ON UPDATE no action;
+EXCEPTION
+ WHEN duplicate_object THEN null;
+END $$;
+--> statement-breakpoint
+DO $$ BEGIN
+ ALTER TABLE "credit_transaction" ADD CONSTRAINT "credit_transaction_user_id_user_id_fk" FOREIGN KEY ("user_id") REFERENCES "public"."user"("id") ON DELETE cascade ON UPDATE no action;
+EXCEPTION
+ WHEN duplicate_object THEN null;
+END $$;
+--> statement-breakpoint
+DO $$ BEGIN
+ ALTER TABLE "user_credit" ADD CONSTRAINT "user_credit_user_id_user_id_fk" FOREIGN KEY ("user_id") REFERENCES "public"."user"("id") ON DELETE cascade ON UPDATE no action;
+EXCEPTION
+ WHEN duplicate_object THEN null;
+END $$;
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "adminAuditLog_adminUserId_idx" ON "admin_audit_log" USING btree ("admin_user_id");--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "adminAuditLog_action_idx" ON "admin_audit_log" USING btree ("action");--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "creditTransaction_userId_idx" ON "credit_transaction" USING btree ("user_id");--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "userCredit_userId_idx" ON "user_credit" USING btree ("user_id");

packages/db/src/migrations/meta/0004_snapshot.json

@@ -0,0 +1,2487 @@
+{
+  "id": "ac52ab5d-b06e-4cd4-8c2a-c38ad8fe4637",
+  "prevId": "f3629c12-2ab8-49c1-b6e5-8b5365ce47dc",
+  "version": "7",
+  "dialect": "postgresql",
+  "tables": {
+    "public.admin_audit_log": {
+      "name": "admin_audit_log",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "admin_user_id": {
+          "name": "admin_user_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "action": {
+          "name": "action",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "target_user_id": {
+          "name": "target_user_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "details": {
+          "name": "details",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "adminAuditLog_adminUserId_idx": {
+          "name": "adminAuditLog_adminUserId_idx",
+          "columns": [
+            {
+              "expression": "admin_user_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "adminAuditLog_action_idx": {
+          "name": "adminAuditLog_action_idx",
+          "columns": [
+            {
+              "expression": "action",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "admin_audit_log_admin_user_id_user_id_fk": {
+          "name": "admin_audit_log_admin_user_id_user_id_fk",
+          "tableFrom": "admin_audit_log",
+          "tableTo": "user",
+          "columnsFrom": [
+            "admin_user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "admin_audit_log_target_user_id_user_id_fk": {
+          "name": "admin_audit_log_target_user_id_user_id_fk",
+          "tableFrom": "admin_audit_log",
+          "tableTo": "user",
+          "columnsFrom": [
+            "target_user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "set null",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.credit_transaction": {
+      "name": "credit_transaction",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "amount": {
+          "name": "amount",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "type": {
+          "name": "type",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "description": {
+          "name": "description",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "tokens_used": {
+          "name": "tokens_used",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "creditTransaction_userId_idx": {
+          "name": "creditTransaction_userId_idx",
+          "columns": [
+            {
+              "expression": "user_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "credit_transaction_user_id_user_id_fk": {
+          "name": "credit_transaction_user_id_user_id_fk",
+          "tableFrom": "credit_transaction",
+          "tableTo": "user",
+          "columnsFrom": [
+            "user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.platform_config": {
+      "name": "platform_config",
+      "schema": "",
+      "columns": {
+        "key": {
+          "name": "key",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true
+        },
+        "value": {
+          "name": "value",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.user_credit": {
+      "name": "user_credit",
+      "schema": "",
+      "columns": {
+        "user_id": {
+          "name": "user_id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true
+        },
+        "token_balance": {
+          "name": "token_balance",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "default": 0
+        },
+        "lifetime_tokens_used": {
+          "name": "lifetime_tokens_used",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "default": 0
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "userCredit_userId_idx": {
+          "name": "userCredit_userId_idx",
+          "columns": [
+            {
+              "expression": "user_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "user_credit_user_id_user_id_fk": {
+          "name": "user_credit_user_id_user_id_fk",
+          "tableFrom": "user_credit",
+          "tableTo": "user",
+          "columnsFrom": [
+            "user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.answer": {
+      "name": "answer",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "section_result_id": {
+          "name": "section_result_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "question_id": {
+          "name": "question_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "user_answer": {
+          "name": "user_answer",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "is_correct": {
+          "name": "is_correct",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "partial_score": {
+          "name": "partial_score",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "time_spent_sec": {
+          "name": "time_spent_sec",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "answer_questionId_idx": {
+          "name": "answer_questionId_idx",
+          "columns": [
+            {
+              "expression": "question_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "answer_section_result_id_section_result_id_fk": {
+          "name": "answer_section_result_id_section_result_id_fk",
+          "tableFrom": "answer",
+          "tableTo": "section_result",
+          "columnsFrom": [
+            "section_result_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "answer_question_id_question_id_fk": {
+          "name": "answer_question_id_question_id_fk",
+          "tableFrom": "answer",
+          "tableTo": "question",
+          "columnsFrom": [
+            "question_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {
+        "answer_unique_idx": {
+          "name": "answer_unique_idx",
+          "nullsNotDistinct": false,
+          "columns": [
+            "section_result_id",
+            "question_id"
+          ]
+        }
+      },
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.combo_package": {
+      "name": "combo_package",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "title": {
+          "name": "title",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "description": {
+          "name": "description",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "creator_user_id": {
+          "name": "creator_user_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "is_public": {
+          "name": "is_public",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "default": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "comboPackage_creatorUserId_idx": {
+          "name": "comboPackage_creatorUserId_idx",
+          "columns": [
+            {
+              "expression": "creator_user_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "comboPackage_isPublic_idx": {
+          "name": "comboPackage_isPublic_idx",
+          "columns": [
+            {
+              "expression": "is_public",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "combo_package_creator_user_id_user_id_fk": {
+          "name": "combo_package_creator_user_id_user_id_fk",
+          "tableFrom": "combo_package",
+          "tableTo": "user",
+          "columnsFrom": [
+            "creator_user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.combo_section": {
+      "name": "combo_section",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "combo_id": {
+          "name": "combo_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "source_package_id": {
+          "name": "source_package_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "source_section_id": {
+          "name": "source_section_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "order_index": {
+          "name": "order_index",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "default": 0
+        }
+      },
+      "indexes": {
+        "comboSection_comboId_idx": {
+          "name": "comboSection_comboId_idx",
+          "columns": [
+            {
+              "expression": "combo_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "comboSection_sourcePackageId_idx": {
+          "name": "comboSection_sourcePackageId_idx",
+          "columns": [
+            {
+              "expression": "source_package_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "combo_section_combo_id_combo_package_id_fk": {
+          "name": "combo_section_combo_id_combo_package_id_fk",
+          "tableFrom": "combo_section",
+          "tableTo": "combo_package",
+          "columnsFrom": [
+            "combo_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "combo_section_source_package_id_test_package_id_fk": {
+          "name": "combo_section_source_package_id_test_package_id_fk",
+          "tableFrom": "combo_section",
+          "tableTo": "test_package",
+          "columnsFrom": [
+            "source_package_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "combo_section_source_section_id_package_section_id_fk": {
+          "name": "combo_section_source_section_id_package_section_id_fk",
+          "tableFrom": "combo_section",
+          "tableTo": "package_section",
+          "columnsFrom": [
+            "source_section_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.exam_type": {
+      "name": "exam_type",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true
+        },
+        "name": {
+          "name": "name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "language": {
+          "name": "language",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "description": {
+          "name": "description",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.generation_job": {
+      "name": "generation_job",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "status": {
+          "name": "status",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "'pending'"
+        },
+        "mode": {
+          "name": "mode",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "'quick'"
+        },
+        "exam_type_id": {
+          "name": "exam_type_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "section_type_id": {
+          "name": "section_type_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "question_count": {
+          "name": "question_count",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "progress": {
+          "name": "progress",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "default": 0
+        },
+        "progress_message": {
+          "name": "progress_message",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "logs": {
+          "name": "logs",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "result_json": {
+          "name": "result_json",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "input_json": {
+          "name": "input_json",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "error_message": {
+          "name": "error_message",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "tokens_used": {
+          "name": "tokens_used",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "duration_ms": {
+          "name": "duration_ms",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "completed_at": {
+          "name": "completed_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false
+        }
+      },
+      "indexes": {
+        "generationJob_userId_idx": {
+          "name": "generationJob_userId_idx",
+          "columns": [
+            {
+              "expression": "user_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "generationJob_status_idx": {
+          "name": "generationJob_status_idx",
+          "columns": [
+            {
+              "expression": "status",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "generation_job_user_id_user_id_fk": {
+          "name": "generation_job_user_id_user_id_fk",
+          "tableFrom": "generation_job",
+          "tableTo": "user",
+          "columnsFrom": [
+            "user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.package_rating": {
+      "name": "package_rating",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "package_id": {
+          "name": "package_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "score": {
+          "name": "score",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "packageRating_packageId_idx": {
+          "name": "packageRating_packageId_idx",
+          "columns": [
+            {
+              "expression": "package_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "package_rating_user_id_user_id_fk": {
+          "name": "package_rating_user_id_user_id_fk",
+          "tableFrom": "package_rating",
+          "tableTo": "user",
+          "columnsFrom": [
+            "user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "package_rating_package_id_test_package_id_fk": {
+          "name": "package_rating_package_id_test_package_id_fk",
+          "tableFrom": "package_rating",
+          "tableTo": "test_package",
+          "columnsFrom": [
+            "package_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {
+        "packageRating_unique_idx": {
+          "name": "packageRating_unique_idx",
+          "nullsNotDistinct": false,
+          "columns": [
+            "user_id",
+            "package_id"
+          ]
+        }
+      },
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.package_section": {
+      "name": "package_section",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "package_id": {
+          "name": "package_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "section_type_id": {
+          "name": "section_type_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "title": {
+          "name": "title",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "order_index": {
+          "name": "order_index",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "default": 0
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "packageSection_packageId_idx": {
+          "name": "packageSection_packageId_idx",
+          "columns": [
+            {
+              "expression": "package_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "packageSection_sectionTypeId_idx": {
+          "name": "packageSection_sectionTypeId_idx",
+          "columns": [
+            {
+              "expression": "section_type_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "package_section_package_id_test_package_id_fk": {
+          "name": "package_section_package_id_test_package_id_fk",
+          "tableFrom": "package_section",
+          "tableTo": "test_package",
+          "columnsFrom": [
+            "package_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "package_section_section_type_id_section_type_id_fk": {
+          "name": "package_section_section_type_id_section_type_id_fk",
+          "tableFrom": "package_section",
+          "tableTo": "section_type",
+          "columnsFrom": [
+            "section_type_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.question": {
+      "name": "question",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "exam_type_id": {
+          "name": "exam_type_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "section_type_id": {
+          "name": "section_type_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "format": {
+          "name": "format",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "passage_text": {
+          "name": "passage_text",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "question_text": {
+          "name": "question_text",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "options": {
+          "name": "options",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "correct_answer": {
+          "name": "correct_answer",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "explanation": {
+          "name": "explanation",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "difficulty": {
+          "name": "difficulty",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "default": 3
+        },
+        "skill_tags": {
+          "name": "skill_tags",
+          "type": "text[]",
+          "primaryKey": false,
+          "notNull": false,
+          "default": "'{}'"
+        },
+        "is_case_sensitive": {
+          "name": "is_case_sensitive",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "default": false
+        },
+        "source": {
+          "name": "source",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "'manual'"
+        },
+        "ai_model": {
+          "name": "ai_model",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "ai_prompt_used": {
+          "name": "ai_prompt_used",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "creator_user_id": {
+          "name": "creator_user_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "is_public": {
+          "name": "is_public",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "default": false
+        },
+        "is_featured": {
+          "name": "is_featured",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "default": false
+        },
+        "usage_count": {
+          "name": "usage_count",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "default": 0
+        },
+        "avg_rating": {
+          "name": "avg_rating",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "question_examTypeId_idx": {
+          "name": "question_examTypeId_idx",
+          "columns": [
+            {
+              "expression": "exam_type_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "question_sectionTypeId_idx": {
+          "name": "question_sectionTypeId_idx",
+          "columns": [
+            {
+              "expression": "section_type_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "question_creatorUserId_idx": {
+          "name": "question_creatorUserId_idx",
+          "columns": [
+            {
+              "expression": "creator_user_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "question_isPublic_idx": {
+          "name": "question_isPublic_idx",
+          "columns": [
+            {
+              "expression": "is_public",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "question_format_idx": {
+          "name": "question_format_idx",
+          "columns": [
+            {
+              "expression": "format",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "question_difficulty_idx": {
+          "name": "question_difficulty_idx",
+          "columns": [
+            {
+              "expression": "difficulty",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "question_exam_type_id_exam_type_id_fk": {
+          "name": "question_exam_type_id_exam_type_id_fk",
+          "tableFrom": "question",
+          "tableTo": "exam_type",
+          "columnsFrom": [
+            "exam_type_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "question_section_type_id_section_type_id_fk": {
+          "name": "question_section_type_id_section_type_id_fk",
+          "tableFrom": "question",
+          "tableTo": "section_type",
+          "columnsFrom": [
+            "section_type_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "question_creator_user_id_user_id_fk": {
+          "name": "question_creator_user_id_user_id_fk",
+          "tableFrom": "question",
+          "tableTo": "user",
+          "columnsFrom": [
+            "creator_user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.question_feedback": {
+      "name": "question_feedback",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "question_id": {
+          "name": "question_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "type": {
+          "name": "type",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "note": {
+          "name": "note",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "questionFeedback_questionId_idx": {
+          "name": "questionFeedback_questionId_idx",
+          "columns": [
+            {
+              "expression": "question_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "question_feedback_user_id_user_id_fk": {
+          "name": "question_feedback_user_id_user_id_fk",
+          "tableFrom": "question_feedback",
+          "tableTo": "user",
+          "columnsFrom": [
+            "user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "question_feedback_question_id_question_id_fk": {
+          "name": "question_feedback_question_id_question_id_fk",
+          "tableFrom": "question_feedback",
+          "tableTo": "question",
+          "columnsFrom": [
+            "question_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {
+        "questionFeedback_unique_idx": {
+          "name": "questionFeedback_unique_idx",
+          "nullsNotDistinct": false,
+          "columns": [
+            "user_id",
+            "question_id"
+          ]
+        }
+      },
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.question_rating": {
+      "name": "question_rating",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "question_id": {
+          "name": "question_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "score": {
+          "name": "score",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "questionRating_questionId_idx": {
+          "name": "questionRating_questionId_idx",
+          "columns": [
+            {
+              "expression": "question_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "question_rating_user_id_user_id_fk": {
+          "name": "question_rating_user_id_user_id_fk",
+          "tableFrom": "question_rating",
+          "tableTo": "user",
+          "columnsFrom": [
+            "user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "question_rating_question_id_question_id_fk": {
+          "name": "question_rating_question_id_question_id_fk",
+          "tableFrom": "question_rating",
+          "tableTo": "question",
+          "columnsFrom": [
+            "question_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {
+        "questionRating_unique_idx": {
+          "name": "questionRating_unique_idx",
+          "nullsNotDistinct": false,
+          "columns": [
+            "user_id",
+            "question_id"
+          ]
+        }
+      },
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.section_question": {
+      "name": "section_question",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "section_id": {
+          "name": "section_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "question_id": {
+          "name": "question_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "order_index": {
+          "name": "order_index",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "default": 0
+        }
+      },
+      "indexes": {
+        "sectionQuestion_sectionId_idx": {
+          "name": "sectionQuestion_sectionId_idx",
+          "columns": [
+            {
+              "expression": "section_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "section_question_section_id_package_section_id_fk": {
+          "name": "section_question_section_id_package_section_id_fk",
+          "tableFrom": "section_question",
+          "tableTo": "package_section",
+          "columnsFrom": [
+            "section_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "section_question_question_id_question_id_fk": {
+          "name": "section_question_question_id_question_id_fk",
+          "tableFrom": "section_question",
+          "tableTo": "question",
+          "columnsFrom": [
+            "question_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {
+        "sectionQuestion_unique_idx": {
+          "name": "sectionQuestion_unique_idx",
+          "nullsNotDistinct": false,
+          "columns": [
+            "section_id",
+            "question_id"
+          ]
+        }
+      },
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.section_result": {
+      "name": "section_result",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "attempt_id": {
+          "name": "attempt_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "section_type_id": {
+          "name": "section_type_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "score": {
+          "name": "score",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "max_score": {
+          "name": "max_score",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "time_spent_sec": {
+          "name": "time_spent_sec",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "sectionResult_attemptId_idx": {
+          "name": "sectionResult_attemptId_idx",
+          "columns": [
+            {
+              "expression": "attempt_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "section_result_attempt_id_test_attempt_id_fk": {
+          "name": "section_result_attempt_id_test_attempt_id_fk",
+          "tableFrom": "section_result",
+          "tableTo": "test_attempt",
+          "columnsFrom": [
+            "attempt_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "section_result_section_type_id_section_type_id_fk": {
+          "name": "section_result_section_type_id_section_type_id_fk",
+          "tableFrom": "section_result",
+          "tableTo": "section_type",
+          "columnsFrom": [
+            "section_type_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.section_type": {
+      "name": "section_type",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true
+        },
+        "name": {
+          "name": "name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.test_attempt": {
+      "name": "test_attempt",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "package_id": {
+          "name": "package_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "combo_id": {
+          "name": "combo_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "started_at": {
+          "name": "started_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "finished_at": {
+          "name": "finished_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "total_score": {
+          "name": "total_score",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "max_score": {
+          "name": "max_score",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "status": {
+          "name": "status",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "'in_progress'"
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "testAttempt_userId_idx": {
+          "name": "testAttempt_userId_idx",
+          "columns": [
+            {
+              "expression": "user_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "testAttempt_packageId_idx": {
+          "name": "testAttempt_packageId_idx",
+          "columns": [
+            {
+              "expression": "package_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "testAttempt_status_idx": {
+          "name": "testAttempt_status_idx",
+          "columns": [
+            {
+              "expression": "status",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "test_attempt_user_id_user_id_fk": {
+          "name": "test_attempt_user_id_user_id_fk",
+          "tableFrom": "test_attempt",
+          "tableTo": "user",
+          "columnsFrom": [
+            "user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "test_attempt_package_id_test_package_id_fk": {
+          "name": "test_attempt_package_id_test_package_id_fk",
+          "tableFrom": "test_attempt",
+          "tableTo": "test_package",
+          "columnsFrom": [
+            "package_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "set null",
+          "onUpdate": "no action"
+        },
+        "test_attempt_combo_id_combo_package_id_fk": {
+          "name": "test_attempt_combo_id_combo_package_id_fk",
+          "tableFrom": "test_attempt",
+          "tableTo": "combo_package",
+          "columnsFrom": [
+            "combo_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "set null",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.test_package": {
+      "name": "test_package",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "title": {
+          "name": "title",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "description": {
+          "name": "description",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "exam_type_id": {
+          "name": "exam_type_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "creator_user_id": {
+          "name": "creator_user_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "is_public": {
+          "name": "is_public",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "default": false
+        },
+        "total_questions": {
+          "name": "total_questions",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "default": 0
+        },
+        "total_sections": {
+          "name": "total_sections",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "default": 0
+        },
+        "estimated_duration_min": {
+          "name": "estimated_duration_min",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "usage_count": {
+          "name": "usage_count",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "default": 0
+        },
+        "avg_rating": {
+          "name": "avg_rating",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "is_featured": {
+          "name": "is_featured",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "default": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "testPackage_examTypeId_idx": {
+          "name": "testPackage_examTypeId_idx",
+          "columns": [
+            {
+              "expression": "exam_type_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "testPackage_creatorUserId_idx": {
+          "name": "testPackage_creatorUserId_idx",
+          "columns": [
+            {
+              "expression": "creator_user_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "testPackage_isPublic_idx": {
+          "name": "testPackage_isPublic_idx",
+          "columns": [
+            {
+              "expression": "is_public",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "test_package_exam_type_id_exam_type_id_fk": {
+          "name": "test_package_exam_type_id_exam_type_id_fk",
+          "tableFrom": "test_package",
+          "tableTo": "exam_type",
+          "columnsFrom": [
+            "exam_type_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "test_package_creator_user_id_user_id_fk": {
+          "name": "test_package_creator_user_id_user_id_fk",
+          "tableFrom": "test_package",
+          "tableTo": "user",
+          "columnsFrom": [
+            "creator_user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.account": {
+      "name": "account",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true
+        },
+        "account_id": {
+          "name": "account_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "provider_id": {
+          "name": "provider_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "access_token": {
+          "name": "access_token",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "refresh_token": {
+          "name": "refresh_token",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "id_token": {
+          "name": "id_token",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "access_token_expires_at": {
+          "name": "access_token_expires_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "refresh_token_expires_at": {
+          "name": "refresh_token_expires_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "scope": {
+          "name": "scope",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "password": {
+          "name": "password",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true
+        }
+      },
+      "indexes": {
+        "account_userId_idx": {
+          "name": "account_userId_idx",
+          "columns": [
+            {
+              "expression": "user_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "account_user_id_user_id_fk": {
+          "name": "account_user_id_user_id_fk",
+          "tableFrom": "account",
+          "tableTo": "user",
+          "columnsFrom": [
+            "user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.session": {
+      "name": "session",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true
+        },
+        "expires_at": {
+          "name": "expires_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "token": {
+          "name": "token",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "ip_address": {
+          "name": "ip_address",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "user_agent": {
+          "name": "user_agent",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        }
+      },
+      "indexes": {
+        "session_userId_idx": {
+          "name": "session_userId_idx",
+          "columns": [
+            {
+              "expression": "user_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "session_user_id_user_id_fk": {
+          "name": "session_user_id_user_id_fk",
+          "tableFrom": "session",
+          "tableTo": "user",
+          "columnsFrom": [
+            "user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {
+        "session_token_unique": {
+          "name": "session_token_unique",
+          "nullsNotDistinct": false,
+          "columns": [
+            "token"
+          ]
+        }
+      },
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.user": {
+      "name": "user",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true
+        },
+        "name": {
+          "name": "name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "email": {
+          "name": "email",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "email_verified": {
+          "name": "email_verified",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "default": false
+        },
+        "image": {
+          "name": "image",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "role": {
+          "name": "role",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "'user'"
+        },
+        "suspended": {
+          "name": "suspended",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "default": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {
+        "user_email_unique": {
+          "name": "user_email_unique",
+          "nullsNotDistinct": false,
+          "columns": [
+            "email"
+          ]
+        }
+      },
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.verification": {
+      "name": "verification",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true
+        },
+        "identifier": {
+          "name": "identifier",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "value": {
+          "name": "value",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "expires_at": {
+          "name": "expires_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "verification_identifier_idx": {
+          "name": "verification_identifier_idx",
+          "columns": [
+            {
+              "expression": "identifier",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    }
+  },
+  "enums": {},
+  "schemas": {},
+  "sequences": {},
+  "roles": {},
+  "policies": {},
+  "views": {},
+  "_meta": {
+    "columns": {},
+    "schemas": {},
+    "tables": {}
+  }
+}

packages/db/src/migrations/meta/_journal.json

@@ -29,6 +29,13 @@
       "when": 1777620900000,
       "tag": "0003_repair_feedback_and_package_rating",
       "breakpoints": true
+    },
+    {
+      "idx": 4,
+      "version": "7",
+      "when": 1779604635821,
+      "tag": "0004_left_diamondback",
+      "breakpoints": true
     }
   ]
 }

packages/db/src/schema/app.ts

@@ -507,7 +507,7 @@ export const generationJob = pgTable(
     userId: text("user_id")
       .notNull()
       .references(() => user.id, { onDelete: "cascade" }),
-    status: text("status").notNull().default("pending"), // "pending" | "running" | "completed" | "failed" | "cancelled"
+    status: text("status").notNull().default("pending"), // "pending" | "running_*" | "partial_ready" | "completed" | "completed_partial" | "failed" | "cancelled"
     mode: text("mode").notNull().default("quick"), // "quick" | "agentic"
     examTypeId: text("exam_type_id").notNull(),
     sectionTypeId: text("section_type_id").notNull(),

packages/db/src/seed.ts

@@ -1,6 +1,10 @@
-import { db } from "./index";
+import { drizzle } from "drizzle-orm/node-postgres";
+
+import { loadDatabaseUrl } from "./database-url";
 import { examType, sectionType } from "./schema";
 
+const db = drizzle(loadDatabaseUrl());
+
 const examTypes = [
   { id: "IELTS", name: "IELTS Academic", language: "English", description: "International English Language Testing System" },
   { id: "TOEFL", name: "TOEFL iBT", language: "English", description: "Test of English as a Foreign Language" },

turbo.json

@@ -30,6 +30,9 @@
       "cache": false,
       "persistent": true
     },
+    "db:seed": {
+      "cache": false
+    },
     "db:studio": {
       "cache": false,
       "persistent": true