Welcome to your Library Management System. This guide helps librarians, admins, and students use the site at https://aoishik.tech.
- Role-based access: Admin, Librarian, Student
- Core features: Books inventory, Students directory, Issue/Return with fines, Reports & exports
- Modern UI: Light/Dark theme, mobile-friendly with a hamburger menu
- Open the site: https://aoishik.tech
- Create an account (Sign up) or log in if you already have one.
- Your dashboard shows quick stats and recent activity.
- Admin: Full access. Manage librarians, students, books, issue/return, reports, and settings.
- Librarian: Manage students, books, issue/return, reports.
- Student: View books, reserve (if enabled), view personal history.
- Dashboard: Overview of stats and monthly trends.
- Books: View, add, edit, delete books (admins/librarians). Students can browse/search.
- Students: Manage student records (admins/librarians).
- Issue: Issue and return books; fines are calculated automatically.
- Reports: Analytics plus CSV/PDF exports (inventory, issued, overdue).
- Librarians: Admin-only management of librarian accounts.
- Settings: Personal profile and app settings (admin controls include fines, due days, theme, reservations).
On mobile, use the hamburger icon to open the menu. Tap outside the menu to close it.
- Add a new book with title, author, ISBN, category, year, publisher, and quantity.
- Search and filter by title or author.
- Reservations are optional (controlled by admin in Settings).
- Add or edit student records (name, email, student ID, department, etc.).
- Students created via Sign up are automatically linked to a user account.
- Issue: Select a student and a book. Due date is pre-filled based on settings.
- Return: Scan/search the issue record and complete return. Fines apply for late returns based on “Fine per day”.
- Safety: Return is idempotent—re-running a return won’t double-charge.
- Analytics cards: Open issues, overdue, total students, total books.
- Charts: Monthly issuance trends.
- Exports:
- Inventory CSV and PDF
- Issued books CSV
- Overdue CSV
- App name, fine per day, default due days, default theme, reservation toggle.
- These values affect UI labels, issuing defaults, and fine calculations.
- Click the sun/moon icon to switch light/dark mode.
- Your choice is remembered in the browser.
- Tap the hamburger icon to open navigation.
- If your mobile browser shows an overlay banner, the site ensures the top bar stays clickable.
I can’t see or click the menu on my phone. Try refreshing the page. The top bar is pinned above overlays and should always receive taps.
Why can’t students add books? Only Admins/Librarians can add or edit books by design.
How are fines calculated? Fines = (days past due) × (Fine per day) set in Settings.
- If pages look odd, clear your browser cache and reload.
- If exports don’t download, ensure pop-ups/downloads are allowed.
- Passwords are hashed for security.
- Admin-only utilities (like one-time password reset tools) are not deployed publicly.
- Database and secrets must not be committed to Git.
- Use the provided
config/db.local.php(ignored by Git) to set credentials.
Have feedback or found an issue? Open an issue on the GitHub repository or reach out via the site footer link. Email me at: lms@aoishik.tech
Modern, minimal, and responsive Library Management System built with PHP, MySQL, Tailwind CSS, and vanilla JavaScript. Works on InfinityFree hosting.
- Role-based auth (Admin/Librarian, Student)
- Secure password hashing (password_hash)
- Dashboard metrics and charts (Chart.js)
- Books and Students management (CRUD)
- Issue/Return books with auto fine calculation
- CSV export (inventory)
- Dark/Light mode with preference persistence
- QR codes for books (QRCode.js)
- PHP 7.4+ (works on InfinityFree)
- MySQL (MariaDB)
- Tailwind CDN, Chart.js, SweetAlert2, QRCode.js
- /assets (css, js, images)
- /config/db.php
- /includes (header, footer, navbar, auth)
- /pages (login, dashboard, books, students, issue, reports, settings)
- index.php