📚 Perpustakaan - Library Management System

Overview

Perpustakaan is a modern, user-friendly library management system built with Nuxt.js and Prisma. It provides a comprehensive solution for managing book collections, user memberships, borrowing processes, and administrative tasks.

Features

• 📖 Complete book catalog management
• 👥 User management system with membership tracking
• 📅 Book borrowing and return process
• 📊 Admin dashboard with statistics
• 🔍 Advanced search functionality
• 🔔 Announcement system
• 📝 Report generation
• 💸 Fine management for late returns

Screenshots

Getting Started

Prerequisites

• Node.js (v16 or later)
• npm or yarn
• MySQL database

Installation

1. Clone the repository

git clone https://github.com/4Kbrain/UKKPerpus---FORK.git
cd UKKPerpus

2. Install dependencies

npm install
# or
yarn install

3. Set up your environment variables by creating a .env file in the project root:

DATABASE_URL="mysql://username:password@localhost:3307/db_perpustakaan_ukk"
NUXT_AUTH_BASE_URL="localhost:3000/api/auth"
AUTH_SECRET="your-secret-key-here"
# Generate a secret key using: node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

4. Initialize the database and run migrations

npx prisma migrate dev

5. Start the development server

npm run dev
# or
yarn dev

6. Visit http://localhost:3000 in your browser

Usage Guide

For Library Members

1. Registration: Create a new account from the registration page
2. Browsing Books: Explore the catalog using the search and filter options
3. Borrowing Books:
   • Select a book you want to borrow
   • Click the "Borrow" button
   • Confirm the borrowing period
4. Managing Your Account:
   • View currently borrowed books
   • Check due dates and any applicable fines
   • Update your profile information

For Administrators

1. Managing Books:

   • Add new books to the catalog with complete information
   • Update book details and availability status
   • Remove books from circulation when necessary

2. User Management:

   • Approve new user registrations
   • Manage user roles and permissions
   • Handle account suspensions if needed

3. Loan Processing:

   • Process book checkouts and returns
   • Override due dates when necessary
   • Manage reservation queues

4. Report Generation:

   • Generate usage statistics
   • Track popular books and user activity
   • Monitor overdue books and fines

Troubleshooting

Common Issues

1. Database Connection Errors:

   • Verify your MySQL server is running on port 3307
   • Check that the database name matches db_perpustakaan_ukk
   • Ensure your database credentials are correct in the .env file

2. TypeScript Errors:

   • Some files may show TypeScript errors (red underlines) in your IDE
   • These are expected and won't affect the application's functionality
   • We're continuously working to resolve these issues

3. Prisma Migration Issues:

   • If you encounter problems with migrations, try:

   npx prisma migrate reset
   npx prisma generate
   npx prisma migrate dev

License

License: MIT License

MIT License

Copyright (c) 2025 Aditya Dwi Nugroho

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Contributing

Contributions are welcome! Please ensure you respect the license terms when contributing.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Issues and Support

If you encounter any issues or have suggestions for improvements, please feel free to reach out or open an issue. Our friendly library cat is always happy to help! 😺

Contact

Aditya Dwi Nugroho - @ProgrammerADN - aditadit120420@gmail.com

Project Link: https://github.com/AdityaDwiNugroho/UKKPerpus

---

Made with ❤️ and a little help from our library cat!