fix(api): allow superusers to submit jobs by provisioning proxy user record

feat(ui): clarify Load Example button in jobs console

Author: Tinitto

CHANGELOG.md

@@ -10,6 +10,11 @@ and this project follows versions of format `{year}.{month}.{patch_number}`.
 ### Changed
 
 - `qpi-ui`: Made the metric cards on the Overview dashboard (Active QPUs, Queue Status, Next Booking) clickable so they quickly route to their respective tabs.
+- `qpi-ui`: Clarified the "Load Example" button text and icon in the Jobs Console to read "Load Bell State Example".
+
+### Fixed
+
+- `qpi-ui`: Fixed "authentication required" error that occurred when superusers attempted to submit a quantum job. Superusers are now transparently issued a proxy `users` record with unlimited QPU seconds to satisfy relational constraints.
 
 ## [0.0.30] - 2026-06-26
 

qpi-ui/internal/api/utils.go

@@ -4,6 +4,7 @@ import (
 	"crypto/rand"
 	"encoding/hex"
 	"fmt"
+	"log"
 	"net"
 	"net/http"
 	"qpi/internal/config"
@@ -58,6 +59,50 @@ func getCurrentUser(re *core.RequestEvent) (*db.User, error) {
 		return &user, nil
 	}
 
+	if re.HasSuperuserAuth() && re.Auth != nil {
+		usersCol, err := re.App.FindCollectionByNameOrId("users")
+		if err != nil {
+			return nil, re.Error(http.StatusInternalServerError, "users collection not found", err)
+		}
+
+		record, err := re.App.FindFirstRecordByData("users", "email", re.Auth.Email())
+		if err != nil {
+			// Proxy user does not exist, so create one for superuser
+			record = core.NewRecord(usersCol)
+			// Let PocketBase auto-generate the ID
+			record.Set("email", re.Auth.Email())
+			username := re.Auth.Id
+			if len(username) > 5 {
+				username = username[:5]
+			}
+			record.Set("username", "admin_" + username)
+			record.Set("qpu_seconds", 999999999.0)
+			
+			if err := re.App.SaveNoValidate(record); err != nil {
+				log.Printf("Failed to create proxy user: %v", err)
+				return nil, re.Error(http.StatusInternalServerError, "failed to provision proxy user", err)
+			}
+		}
+
+		var user db.User
+		err = user.RefreshFromRecord(record)
+		if err != nil {
+			return nil, err
+		}
+
+		// Ensure superuser has practically infinite QPU seconds
+		if user.QPUSeconds < 999999999.0 {
+			record.Set("qpu_seconds", 999999999.0)
+			if err := re.App.SaveNoValidate(record); err != nil {
+				log.Printf("Failed to update proxy user quota: %v", err)
+				return nil, re.Error(http.StatusInternalServerError, "failed to update proxy user quota", err)
+			}
+			user.QPUSeconds = 999999999.0
+		}
+
+		return &user, nil
+	}
+
 	token := getToken(re)
 	user, err := db.GetUserByToken(re.App, token)
 	if err != nil {

qpi-ui/internal/dashboard/cypress/e2e/jobs-console/admin-job-submission.cy.ts

@@ -0,0 +1,32 @@
+describe("Jobs Console — Admin Job Submission", () => {
+  beforeEach(() => {
+    cy.clearCookies();
+    cy.clearLocalStorage();
+    cy.visit("/");
+
+    // Login as admin
+    cy.contains("button", "Administrator").click();
+    cy.get('input[type="text"]').clear().type("admin@example.com");
+    cy.get('input[type="password"]').clear().type("supersecretpassword1234");
+    cy.get('button[type="submit"]').click();
+    cy.contains("h1", "QPI Interface").should("be.visible");
+
+    cy.contains("button", "Jobs Console").click();
+    cy.contains("h1", "Jobs Console").should("be.visible");
+  });
+
+  it("submits a job successfully as an admin", () => {
+    // Execute job with default form values
+    cy.contains("button", "Execute Job").click();
+
+    // Wait for the job to complete
+    cy.contains("div", "completed", { timeout: 15000 }).should("be.visible");
+
+    // Verify duration is displayed
+    cy.contains("span", "Duration")
+      .parent()
+      .find("span.font-mono")
+      .should("be.visible")
+      .and("contain", "s");
+  });
+});

qpi-ui/internal/dashboard/src/components/tabs/JobsConsoleTab/elements/JobSubmissionPanel.tsx

@@ -1,5 +1,5 @@
 import React, { useState, useEffect } from "react";
-import { Copy, Play, Loader2 } from "lucide-react";
+import { FileCode, Play, Loader2 } from "lucide-react";
 import type { QPU } from "@/types";
 
 interface Props {
@@ -102,9 +102,10 @@ export const JobSubmissionPanel: React.FC<Props> = ({
           </span>
           <button
             onClick={loadExample}
-            className="text-gray-400 dark:text-zinc-500 hover:text-gray-900 dark:text-white text-xs transition-colors flex items-center gap-1 focus:outline-none"
+            title="Load a simple Bell State entanglement circuit"
+            className="text-gray-400 dark:text-zinc-500 hover:text-gray-900 dark:text-white text-xs transition-colors flex items-center gap-1.5 focus:outline-none"
           >
-            <Copy className="w-3.5 h-3.5" /> Load Example
+            <FileCode className="w-3.5 h-3.5" /> Load Bell State Example
           </button>
         </div>
         <textarea