How mariamqua/quarne_boitepizza works
Project Type and Purpose
• This is a full-stack PHP web application built on the Laravel framework, augmented by the Backpack admin panel and various front-end packages.
• Purpose: provide CRUD management (categories, products, clients, formules, commentaires) via a secure admin interface and publicly facing views (welcome page, error handlers).
Architectural Pattern
• MVC (Model-View-Controller) at its core:
• Models (app/Models) encapsulate Eloquent ORM and database tables.
• Controllers (app/Http/Controllers and subdirectories) handle HTTP requests, invoke business logic, and return views or JSON.
• Views (resources/views) contain Blade templates rendered server-side.
• Middleware (app/Http/Middleware) enforces authentication, admin checks, CSRF protection.
• Service Providers (app/Providers) bootstrap framework features (routing, events, authentication).
• Asset pipeline: Webpack (webpack.mix.js), Mix compiles SASS, JS under resources/, served from public/.
Main Components
• Client (Browser)
• Web Server (Apache/Nginx) serving public/index.php
• Laravel Application Kernel
• HTTP Kernel: request passes through global and route middleware
• Route definitions (routes/web.php, routes/api.php, routes/backpack)
• Controllers & Requests
• Backpack CrudControllers for Admin (e.g. ProduitCrudController)
• FormRequest validation classes (app/Http/Requests)
• Models & Database
• Eloquent Models
• MySQL (or configured RDBMS) with migrations in database/migrations
• Views & Assets
• Blade templates
• Public assets (CSS/JS under public/packages)
• Compiled app.js/app.css
• External Services
• Email (config/mail.php)
• Cache/Session store (Redis or file)
• Optional queue worker (config/queue.php)
• File storage (local/public or AWS via config/filesystems.php)
Important Patterns & Principles
• Separation of Concerns (MVC)
• Dependency Injection via Service Container
• RESTful routing for resource controllers in admin area
• Configuration-driven: .env, config/*.php
• Asset versioning and cache busting via Mix
• Secure areas guarded by middleware (Authenticate, CheckIfAdmin)