How abhipraya-kusuma-dev/seragam-app works
Project type and purpose
• This is a full-stack Laravel web application (“Seragam App”) for managing uniform (seragam) orders, inventory, measurement (ukur), and reporting.
• It uses Blade templates and Tailwind CSS/Vite for the UI, a MySQL (or other SQL) database for persistence, a Node.js Socket.IO server for real-time updates, and Laravel Excel for import/export features.
File structure
• Top-level ‘app’ directory follows the Laravel MVC pattern:
• Controllers (app/Http/Controllers, including API‐specific controllers)
• Models (app/Models)
• Middleware (app/Http/Middleware)
• Console commands and scheduled tasks (app/Console)
• Exports/Imports (app/Exports, app/Imports)
• Service providers (app/Providers)
• ‘routes’ holds web, API, console, and broadcasting routes.
• ‘resources’ holds UI assets: Blade views (resources/views), CSS/JS modules (resources/css, resources/js) configured via tailwind.config.js and vite.config.js.
• ‘public’ serves the entry point (index.php), static assets, and an Excel template.
• ‘server.cjs’ at project root is a separate Node.js service running Socket.IO on port 3000.
• Configuration files under ‘config’, database migrations/seeders under ‘database’, and environment variables in ‘.env’.
Key insights from README
• PHP 8.2, Composer, NPM are required.
• Run php artisan serve for the Laravel app and node server.cjs for the real-time Socket.IO server.
• Database migrations set up users, orders, uniforms (seragam), statuses.
• Sanctum is configured (config/sanctum.php) for API authentication if needed.
Implementation notes for maximum detail
• Middleware chain upstream of controllers.
• Console Kernel if scheduled jobs (migrations, exports) are significant.
• Explicitly show the Excel template in public/excel and the import workflow via SeragamImport.
• Link the Laravel BroadcastServiceProvider to the Socket.IO server to illustrate real-time event flow.