Librarian Portal

Route prefix: /librarian/* Layout: frontend/src/app/librarian/layout.tsx Required role: ROLE_LIBRARIAN

The Librarian portal is optimized for day-to-day library desk operations — processing checkouts and returns, managing inventory, and browsing the catalogue.

Layout Structure

The librarian layout uses the same sidebar + top navigation pattern as the admin portal:

<SidebarProvider>
  <AppSidebar role="librarian" />
  <div className="min-h-screen bg-background flex flex-col flex-1 w-full">
    <TopNav />
    <main className="flex-1">{children}</main>
  </div>
</SidebarProvider>

Sidebar Navigation

Pages

1. Desk Overview (/librarian/overview)

File: librarian/overview/page.tsx

The librarian's at-a-glance dashboard showing operational metrics relevant to daily desk work.

Features:

• Quick stats for active loans, pending returns, and queue status
• Recent activity feed
• Quick action buttons for common desk operations

2. Circulation (/librarian/circulation)

File: librarian/circulation/page.tsx

The primary operational page for processing book checkouts and returns.

Features:

• Issue book form with User ID and Book Copy ID inputs
• Return book form with Transaction ID input
• Active loans table showing currently checked-out items
• Quick-action buttons for common circulation tasks

API Integration:

• Issue: POST /api/v1/circulation/issue
• Return: POST /api/v1/circulation/return
• Active loans: GET /api/v1/circulation/active

3. Inventory (/librarian/inventory)

File: librarian/inventory/page.tsx

Physical copy management — tracking barcodes, shelf locations, and copy conditions.

Capabilities:

• View all physical book copies with status indicators
• Update copy status (AVAILABLE, MAINTENANCE, LOST)
• View copy location information

4. Catalogue (/librarian/books)

File: librarian/books/page.tsx

Browse and search the book catalogue with editing capabilities.

Features:

• Searchable book list with title, author, ISBN filtering
• View book details with associated copies
• Add new book entries and copies

API Integration:

• List books: GET /api/v1/books
• Book details: GET /api/v1/books/:id

5. Notifications (/librarian/notifications)

File: librarian/notifications/page.tsx

Notification feed for desk-related alerts — reservation pickups, overdue reminders, and system messages.

6. Profile (/librarian/profile)

File: librarian/profile/page.tsx

Personal profile management for the librarian account.

Key Difference from Admin Portal

The librarian portal is a focused subset of admin capabilities:

• ❌ No user management (cannot create/edit users)
• ❌ No system settings or reports
• ❌ No fine policy configuration
• ✅ Full circulation desk access
• ✅ Inventory and catalogue management