How rakshat28/brain works
Project type and purpose
• This is a monolithic, full-stack Laravel application (Freshman CMS) built on the TALL stack (Tailwind, Alpine, Laravel, Livewire).
• It provides both server-rendered web pages (Blade + Livewire), a versioned JSON API (routes/api.php → Api/V1 controllers → Resources), background jobs & scheduled console commands, and integrations with external services (SMS, push notifications, PDF/ImageKit, IoT device ingestion).
• Use cases include CMS features (news, pages, menus), water-scheme management, grievance tracking, geospatial map displays, IoT device telemetry, multi-tenant support, reporting, and PDF exports.
File structure
Top-level directories:
• /app – core code:
– Http/Controllers – Web controllers + Api/V1 controllers
– Http/Livewire – reactive UI components
– Console/Commands – scheduled scripts
– Models, Enums, Services, Repositories, Notifications, Events & Listeners, Policies
– Middleware – authentication, tenant checks, API logging, transaction management
• /resources – view templates (Blade), Livewire views, front-end assets (css/js)
• /public – webroot, compiled assets, GeoJSON, static files
• /database – migrations, seeders, schema snapshots
• /config – Laravel and third-party service configuration (queue, broadcasting, mail, etc.)
• /routes – web.php (UI routes), api.php (JSON endpoints), console.php (job scheduling)
• bootstrap, storage, vendor, tests, artisan
README for additional insights
• Confirms the TALL-stack foundation and rapid prototyping focus
• Uses Laravel Breeze for authentication scaffolding
• Describes local setup (composer, npm, migrations, seeding, storage linking)