How shluf/asmr works
Project type and purpose
• This is a full-stack, monolithic Laravel application that uses Inertia.js with React (JSX files under resources/js) to deliver a Single-Page Application (SPA) in the browser.
• Purpose: “Aplikasi Surat Menyurat RT/RW” – an online letter-submission platform for residents (“warga”) and local administrators (RT/RW) to submit, approve, track, and archive official letters and to broadcast local work programs.
File structure
• Top-level:
• app/ contains the MVC backend (Controllers, Models, Middleware, Services, Observers)
• resources/js and resources/css hold the React SPA assets and styling (Vite + Tailwind)
• routes/ defines HTTP entry points (web.php, auth.php)
• database/ migrations & seeders for MySQL schema
• public/ index.php and compiled assets served to clients
• Architectural patterns:
• MVC (app/Models, app/Http/Controllers)
• Service layer (app/Services/SuratService.php)
• Observer pattern (app/Observers) for model event hooks
• Inertia.js bridges backend controllers to React pages
• Configuration & deployment:
• .env, config/*.php for environment & services
• vite.config.js, tailwind.config.js, package.json for frontend build
• artisan, composer.json for PHP commands & dependencies
README insights
• Tech stack: PHP 8+, Laravel 10, MySQL, Node.js, Vite, Inertia.js, React, Tailwind CSS
• Functional modules: Authentication, Role-based approval workflow, PDF generation (SuratPDFController), Email notifications, Program kerja display, Dashboard per role.