fix(ui): add navbar link to API Docs alongside system reset

backend/src/models/jd.py

@@ -25,5 +25,6 @@ class JobDescription(Base):
     embedding_text: Mapped[str | None] = mapped_column(Text, nullable=True)
     qdrant_id: Mapped[str | None] = mapped_column(String(64), nullable=True)
     status: Mapped[str] = mapped_column(String(32), default="pending")
+    session_id: Mapped[uuid.UUID | None] = mapped_column(UUID(as_uuid=True), nullable=True)
     created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), server_default=func.now())
     updated_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), server_default=func.now(), onupdate=func.now())

backend/src/routers/jds.py

@@ -17,6 +17,7 @@ async def create_jd(payload: JDCreate, db: AsyncSession = Depends(get_db)):
         id=uuid.uuid4(),
         title=payload.title,
         raw_text=payload.raw_text,
+        session_id=payload.session_id,
         status="processing",
     )
     db.add(jd)
@@ -29,8 +30,11 @@ async def create_jd(payload: JDCreate, db: AsyncSession = Depends(get_db)):
 
 
 @router.get("", response_model=list[JDListItem])
-async def list_jds(db: AsyncSession = Depends(get_db)):
-    result = await db.execute(select(JobDescription).order_by(JobDescription.created_at.desc()).limit(50))
+async def list_jds(session_id: uuid.UUID | None = None, db: AsyncSession = Depends(get_db)):
+    stmt = select(JobDescription).order_by(JobDescription.created_at.desc())
+    if session_id:
+        stmt = stmt.where(JobDescription.session_id == session_id)
+    result = await db.execute(stmt.limit(50))
     return result.scalars().all()
 
 

backend/src/schemas/jd.py

@@ -7,6 +7,7 @@ from pydantic import BaseModel, Field
 class JDCreate(BaseModel):
     title: str
     raw_text: str
+    session_id: UUID | None = None
 
 
 class JDResponse(BaseModel):
@@ -30,6 +31,7 @@ class JDListItem(BaseModel):
     id: UUID
     title: str
     status: str
+    session_id: UUID | None = None
     jd_quality: dict[str, Any] = {}
     created_at: datetime
 

frontend/src/app/layout.tsx

@@ -20,6 +20,9 @@ export default function RootLayout({ children }: { children: React.ReactNode })
               <Link href="/reset" className="px-3 py-1.5 rounded-lg text-xs font-medium text-slate-500 hover:text-red-400 transition-colors">
                 Reset
               </Link>
+              <a href="/docs" target="_blank" rel="noreferrer" className="px-3 py-1.5 rounded-lg text-xs font-medium text-slate-500 hover:text-[var(--color-brand-light)] transition-colors">
+                API Docs ↗
+              </a>
               <Link href="/pipeline" className="ml-2 px-3 py-1.5 rounded-lg text-sm font-semibold text-[var(--color-brand-light)] bg-[var(--color-brand-dim)] border border-[var(--color-brand-glow)] hover:bg-[var(--color-brand)] hover:text-white transition-all">
                 ⚡ Auto Pipeline
               </Link>

frontend/src/app/pipeline/page.tsx

@@ -127,17 +127,19 @@ export default function PipelinePage() {
     updateState({ status: "uploading", sessionName, jdsInfo: jds, startTime: start, elapsedTime: 0 });
 
     try {
-      // 1. Create Session & JDs parallel
-      const sessionPromise = api.createSession(sessionName, "Automated Candidate Batch Ingestion");
-      const jdPromises = jds.map(jd => api.createJD(jd.title, jd.desc));
-
-      const [session, ...createdJDs] = await Promise.all([sessionPromise, ...jdPromises]);
+      // 1. Create Session first
+      const session = await api.createSession(sessionName, "Automated Candidate Batch Ingestion");
+      const sessionIdStr = (session as any).id;
+      
+      // 2. Create JDs scoped to that session
+      const jdPromises = jds.map(jd => api.createJD(jd.title, jd.desc, sessionIdStr));
+      const createdJDs = await Promise.all(jdPromises);
       const jdIds = createdJDs.map(j => (j as any).id);
       
-      updateState({ sessionId: (session as any).id, jdIds });
+      updateState({ sessionId: sessionIdStr, jdIds });
 
-      // 2. Upload file
-      const uploadRes = await api.uploadCandidates(file, (session as any).id);
+      // 3. Upload file
+      const uploadRes = await api.uploadCandidates(file, sessionIdStr);
       
       updateState({ status: "embedding", taskId: uploadRes.task_id });
       

frontend/src/app/sessions/[id]/page.tsx

@@ -37,18 +37,11 @@ export default function SessionDetailPage({ params }: { params: Promise<{ id: st
 
   const loadData = useCallback(async () => {
     try {
-      const [s, jList] = await Promise.all([api.getSession(sessionId), api.listJDs()]);
+      const [s, jList] = await Promise.all([api.getSession(sessionId), api.listJDs(sessionId)]);
       setSession(s);
-
-      // Filter JDs to only those created for this specific session
-      // The pipeline page stores this mapping in localStorage when it finishes
-      let filteredJDs = jList as JD[];
-      try {
-        const mapping = JSON.parse(localStorage.getItem("tp_session_jds") || "{}");
-        if (mapping[sessionId] && Array.isArray(mapping[sessionId]) && mapping[sessionId].length > 0) {
-          filteredJDs = filteredJDs.filter(jd => mapping[sessionId].includes(jd.id));
-        }
-      } catch (e) { }
+      
+      // JDs are now natively scoped to the session id via the backend API
+      const filteredJDs = jList as JD[];
       setJDs(filteredJDs);
 
       // If a JD is selected, load its match info automatically

frontend/src/lib/api.ts

@@ -120,9 +120,9 @@ export const api = {
   getSession: (id: string) => request<SessionInfo>(`/api/sessions/${id}`),
   deleteSession: (id: string) => request<void>(`/api/sessions/${id}`, { method: "DELETE" }),
 
-  createJD: (title: string, raw_text: string) =>
-    request<JD>("/api/jds", { method: "POST", body: JSON.stringify({ title, raw_text }) }),
-  listJDs: () => request<JD[]>("/api/jds"),
+  createJD: (title: string, raw_text: string, session_id?: string) =>
+    request<JD>("/api/jds", { method: "POST", body: JSON.stringify({ title, raw_text, session_id }) }),
+  listJDs: (session_id?: string) => request<JD[]>(session_id ? `/api/jds?session_id=${session_id}` : "/api/jds"),
   getJD: (id: string) => request<JD>(`/api/jds/${id}`),
   updateJDWeights: (id: string, weights: Record<string, number>) => 
     request<JD>(`/api/jds/${id}/weights`, { method: "PATCH", body: JSON.stringify({ weights }) }),

nginx.conf

@@ -31,6 +31,20 @@ http {
             proxy_pass http://127.0.0.1:8000/health;
         }
 
+        # Route FastAPI Swagger Docs correctly
+        location /docs {
+            proxy_pass http://127.0.0.1:8000/docs;
+            proxy_set_header Host $host;
+            proxy_set_header X-Real-IP $remote_addr;
+        }
+
+        # Route OpenAPI schema for Swagger
+        location /openapi.json {
+            proxy_pass http://127.0.0.1:8000/openapi.json;
+            proxy_set_header Host $host;
+            proxy_set_header X-Real-IP $remote_addr;
+        }
+
         location / {
             proxy_pass http://127.0.0.1:3000;
             proxy_set_header Host $host;