The Admin Dashboard provides comprehensive control over the CS Library Kiosk system, allowing administrators to manage books, users, and monitor library activity.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/AmilcarArmmand/CS_Library_Nuc_Project/llms.txt
Use this file to discover all available pages before exploring further.
Admin Access
Administrators access the system using email and password authentication, separate from the student ID card scanning system.Login Credentials
Admins log in through the web interface at the/ route using:
- Email address (stored in lowercase)
- Password (hashed with bcrypt)
Test admin account:
[email protected] / Password as configured in your databaseAuthentication Flow
Authenticate
The system validates your credentials using bcrypt password verification:
- Email is normalized to lowercase
- Password is checked against the hashed password in the database
- Active status is verified (
active = 1)
Admin Capabilities
As an administrator, you have access to:Book Management
- Add new books via manual entry or ISBN API lookup
- Update book status (Available, Checked Out)
- Manage book metadata (title, author, cover image, shelf location)
- View complete catalog with real-time availability
User Management
- View all registered users
- Monitor user borrowing activity
- Manage user active status
- View user checkout history and current loans
Reports & Analytics
- Generate usage statistics
- View checkout history across all users
- Identify popular books and usage patterns
- Export data for analysis
System Monitoring
- Real-time inventory status
- Transaction logs
- Overdue book tracking
Security Features
Admin passwords are stored using bcrypt hashing (database.py:80, 112)
Active status controls admin access - inactive admins cannot log in
Email addresses are case-insensitive and stored in lowercase (database.py:88, 109)
Navigation
From the admin dashboard, you can navigate to:- Book Management - Add and maintain the library catalog
- User Management - Manage user accounts and permissions
- Reports - Generate analytics and export data
Session Management
The current implementation uses NiceGUI’s session management. The SRS specifies:
- Session timeout after 15 minutes of inactivity
- Automatic logout for security
Admin vs Student Access
Key differences between admin and student access:| Feature | Students | Administrators |
|---|---|---|
| Authentication | Student ID card scan | Email/Password |
| Book Checkout | Self-service | Full access |
| Catalog Management | View only | Full CRUD |
| User Management | Own account only | All users |
| Reports | Personal history | System-wide |
| System Settings | No access | Full access |
Next Steps
Manage Books
Add new books and maintain the catalog
Manage Users
View and manage user accounts
View Reports
Generate usage statistics and analytics
System Config
Configure system settings