Library Management System

Full-stack library management system with Laravel API and React frontend. Handles book cataloging, user management, loan tracking, and automated fine calculation.

Features

• User authentication and role-based access control
• Book catalog with search and filtering
• Loan management and tracking
• Automated fine calculation for overdue books
• Library card issuance and renewal
• Dashboard with statistics

Tech Stack

• Backend: Laravel 12, PHP 8.2+
• Frontend: React 19, TypeScript, Inertia.js
• Styling: Tailwind CSS
• Database: PostgreSQL or MySQL

Requirements

• PHP 8.2 or higher
• Composer 2.x
• Node.js 18+
• PostgreSQL or MySQL

Installation

1. Clone the repository:

   git clone https://github.com/PhucTruong-ctrl/library-management-system.git
   cd library-management-system

2. Install PHP dependencies:

   composer install

3. Install JavaScript dependencies:

   npm install

4. Configure environment:

   cp .env.example .env
   php artisan key:generate

5. Set up database credentials in .env and run migrations:

   php artisan migrate --seed

Usage

Start the development server:

composer run dev

Or run separately:

php artisan serve
npm run dev

Access the application at http://localhost:8000

Project Structure

app/
  Http/Controllers/   - Request handlers
  Models/             - Eloquent models
  Services/           - Business logic
resources/
  js/                 - React components
  views/              - Blade templates
database/
  migrations/         - Database migrations
  seeders/            - Data seeders

Contributing

Contributions are welcome. Please open an issue first to discuss proposed changes.

License

MIT License