How romelgo/chambea-ya works
Main System Components
• Web Client (Browser / Mobile)
• Load Balancer / Web Server (Apache/nginx + .htaccess)
• Laravel App Server (PHP-FPM)
• Vue.js Frontend (served via Blade templates + standalone SPA assets)
• MySQL Database
• File Storage (local / public/uploads)
• Caching Layer (Laravel cache, e.g. file/Redis)
• Queue Worker(s) (php artisan queue:work)
• Mail Service (SMTP / external provider)
• Optional: API Server (routes/api.php + Sanctum tokens)
Relationships & Data Flows
• Client → HTTP(S) → Load Balancer/Web Server
• Hosts static assets (public/) and proxies PHP requests.
• Web Server → PHP-FPM → Laravel Kernel
• Kernel dispatches through Middleware → Controllers → Models → Database / Cache / Storage.
• Laravel → MySQL
• All CRUD operations, migrations, relationships.
• Laravel → File Storage
• User-uploaded resumes, avatars in storage/app/public → served via public/uploads.
• Laravel → Cache
• Session data, route caching, query caching.
• Laravel → Queue Worker
• Jobs (e.g., SendJob email) pushed to queue table, processed asynchronously.
• Laravel → Mail Service
• Outgoing notifications, application confirmations (app/Mail).
• Client ← REST JSON APIs
• Vue components (resources/js) may call API endpoints (routes/api.php) for dynamic features.
Architectural Patterns
• MVC Pattern:
• Models (app/Models)
• Views (resources/views + Vue templates)
• Controllers (app/Http/Controllers)
• Middleware Chain:
• Authentication (Sanctum, session), CSRF, role guards (Seeker, Employer, Admin).
• Service Providers / IoC Container (app/Providers)
• Blade + Vue Hybrid:
• Blade drives page shells; Vue components handle dynamic widgets.
• RESTful Routes + API
• Separate web (routes/web.php, routes/admin.php) & API layers.
Technologies & Frameworks to Annotate
• Laravel 10.x (PHP 8.x)
• Vue.js (2.x/3.x via Vite)
• MySQL (or MariaDB)
• Composer, NPM, Vite.js
• Mailer: SwiftMailer / Mailgun / SMTP
• Queue: Database or Redis driver
• Cache: file or Redis (config/cache.php)
• Authentication: Laravel Sanctum + default guards