Germa-Studio/LitraDesa

LitraDesa (Literasi Desa Digital) is a comprehensive ecosystem designed to modernize village libraries. Unlike traditional systems, LitraDesa focuses on a hybrid approach: making physical book borrowing frictionless through technology while providing a premium digital reading experience. # 🏛️ LitraDesa - Village Library Management System LitraDesa (Literasi Desa Digital) is a comprehensive hybrid physical-digital village library management system designed for rural Indonesia. It combines QR-based physical book management with a premium digital reading experience. ## 📋 Table of Contents - Features - Tech Stack - Prerequisites - Quick Start - Detailed Setup - Development Workflow - Production Deployment - Architecture - Troubleshooting - Contributing - License ## ✨ Features ### Core Features - 📚 **Dual Book System**: Physical books (Hardbooks) and digital books (Softbooks) - 📱 **QR-Centric Workflow**: Scan member card + book = instant loan/return ( ⚠️ **Important**: Change the default password immediately after first login! ## 📖 Detailed Setup ### Manual Setup (Alternative to init.sh) If you prefer manual setup or the script fails: #### Step 1: Create Laravel Project ```bash # Create Laravel 11 project composer create-project laravel/laravel:^11.0 src cd src ``` #### Step 2: Install Inertia.js and React ```bash # Install Inertia.js server-side composer require inertiajs/inertia-laravel # Install Inertia.js client-side + React npm install @inertiajs/react react react-dom # Install Laravel Breeze with Inertia + React composer require laravel/breeze --dev php artisan breeze:install react # Install dependencies npm install ``` #### Step 3: Install Laravel Reverb ```bash # Install Reverb composer require laravel/reverb # Publish Reverb configuration php artisan reverb:install ``` #### Step 4: Configure Environment ```bash # Copy environment file cp .env.example .env # Generate application key php artisan key:generate # Update database configuration in .env DB_CONNECTION=pgsql DB_HOST=db DB_PORT=5432 DB_DATABASE=litradesa DB_USERNAME=litradesa_user DB_PASSWORD=litradesa_password # Update Redis configuration REDIS_HOST=redis REDIS_PORT=6379 # Update Reverb configuration REVERB_HOST=reverb REVERB_PORT=8080 ``` #### Step 5: Buil …