Smart Library Docs

Staff Portal

Documentation for the Staff/Faculty portal — extended loan management, catalogue browsing, and reservations.

Staff Portal (Faculty)

Route prefix: /staff/* Layout: frontend/src/app/staff/layout.tsx Required role: ROLE_STAFF

The Staff portal serves faculty members with extended library privileges — longer loan periods, catalogue access, and self-service loan and reservation management.

Menu ItemRouteIcon
Overview/staff/overviewLayoutDashboard
My Loans/staff/loansBookCopy
Reservations/staff/reservationsBookmark
Catalogue/staff/booksSearch
Notifications/staff/notificationsBell
Profile/staff/profileUser

Pages

1. Overview (/staff/overview)

File: staff/overview/page.tsx

Faculty dashboard with personalized greeting and loan summary.

Features:

  • Active loans count and due date reminders
  • Recent borrowing activity
  • Quick access to catalogue search

2. My Loans (/staff/loans)

File: staff/loans/page.tsx

Table of currently borrowed items with renewal capabilities.

Features:

  • Data table with book titles, authors, due dates, and statuses
  • Renewal request buttons
  • Overdue indicators

3. Reservations (/staff/reservations)

File: staff/reservations/page.tsx

Manage book hold requests.

Features:

  • Active reservation list with status tracking
  • Queue position information
  • Cancellation options for pending holds

4. Catalogue (/staff/books)

File: staff/books/page.tsx

Browse and search the complete library catalogue.

Features:

  • Full catalogue search with filters
  • Book detail views with availability status
  • Category-based browsing

API Integration: GET /api/v1/books


5. Notifications (/staff/notifications)

File: staff/notifications/page.tsx

In-app notification feed for due date reminders, reservation alerts, and system messages.


6. Profile (/staff/profile)

File: staff/profile/page.tsx

Personal profile view and account settings.


Staff vs. Student Portal

FeatureStudentStaff
Loan Period14 days30 days
Fines Page❌ (not shown in nav)
Reservations
Catalogue Access
Max RenewalsStandardExtended

The primary difference is that staff members have extended loan periods (30 days vs. 14 days for students) and the staff portal omits the Fines page from the sidebar navigation since faculty accounts are handled differently.

On this page