Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Henry4ndrew/saborGestion/llms.txt
Use this file to discover all available pages before exploring further.
SaborGestion follows the standard Laravel 12 application layout with a clear separation of concerns across controllers, models, views, and routes.
Technology stack
| Layer | Technology |
|---|
| Framework | Laravel 12 |
| PHP | ^8.2 |
| Frontend templates | Blade |
| CSS framework | Tailwind CSS |
| Asset bundler | Vite |
| Database | MySQL (saborGestion) |
| Authentication | Laravel Breeze ^2.4 |
| Development tools | Laravel Pail, Laravel Pint, Laravel Sail |
Directory tree
The following tree is taken directly from the project source:
saborGestion/
├── app/
│ ├── Http/
│ │ ├── Controllers/
│ │ │ ├── Auth/
│ │ │ ├── DashboardController.php
│ │ │ ├── ProductoController.php
│ │ │ ├── InventarioController.php
│ │ │ ├── MesaController.php
│ │ │ ├── PedidoController.php
│ │ │ ├── ComandaController.php
│ │ │ ├── DeliveryController.php
│ │ │ ├── FacturaController.php
│ │ │ ├── PagoController.php
│ │ │ ├── CierreCajaController.php
│ │ │ └── UsuarioController.php
│ │ └── Middleware/
│ │ └── RoleMiddleware.php
│ ├── Models/
│ │ ├── User.php
│ │ ├── Producto.php
│ │ ├── Inventario.php
│ │ ├── Mesa.php
│ │ ├── Pedido.php
│ │ ├── Comanda.php
│ │ ├── Delivery.php
│ │ ├── Factura.php
│ │ ├── Pago.php
│ │ └── CierreCaja.php
│ └── Providers/
│ └── AppServiceProvider.php
├── database/
│ ├── migrations/
│ └── seeders/
├── resources/
│ └── views/
│ ├── layouts/
│ │ ├── sidebar.blade.php
│ │ └── app.blade.php
│ ├── auth/
│ │ └── login.blade.php
│ ├── dashboard/
│ │ ├── administrador/
│ │ ├── mesero/
│ │ ├── cocinero/
│ │ └── cajero/
│ ├── productos/
│ ├── inventario/
│ ├── mesas/
│ ├── pedidos/
│ ├── comandas/
│ ├── delivery/
│ ├── facturas/
│ ├── pagos/
│ ├── cierres/
│ └── usuarios/
├── routes/
│ ├── web.php
│ └── api.php
└── tailwind.config.js
Key directories
app/Http/Controllers/
Contains one controller per domain area, each handling HTTP requests for a specific section of the application.
| Controller | Responsibility |
|---|
Auth/ | Login, logout, and password reset (generated by Breeze) |
DashboardController | Role-aware dashboard routing (administrador, mesero, cocinero, cajero) |
ProductoController | CRUD operations for menu products |
InventarioController | Ingredient stock management |
MesaController | Table status and capacity management |
PedidoController | Order lifecycle (creation through delivery) |
ComandaController | Kitchen line items linked to orders |
DeliveryController | Delivery order tracking |
FacturaController | Pre-invoice and invoice generation |
PagoController | Payment recording per invoice |
CierreCajaController | End-of-day cash register closes |
UsuarioController | User CRUD (admin only) |
app/Http/Middleware/
Contains RoleMiddleware, which enforces role-based access control on authenticated routes. See Middleware for full documentation.
app/Models/
One Eloquent model per database table. Models declare $fillable columns and $casts. See Database schema for column definitions and Models for relationship details.
app/Providers/
Contains AppServiceProvider, the standard Laravel application service provider used for bootstrapping application services.
database/migrations/
All schema definitions live here as timestamped migration files. The migration order establishes foreign-key dependencies:
Core Laravel tables
users, password_reset_tokens, sessions, cache, jobs
Role column
add_role_to_users_table — adds the role enum to users
Catalog tables
productos, inventarios, mesas
Order pipeline tables
pedidos → comandas → deliveries
Billing tables
facturas → pagos
Reporting table
cierre_cajas
resources/views/
Blade templates organized by section. Every section has at least an index.blade.php. CRUD sections (productos, usuarios) also include create.blade.php, edit.blade.php, and show.blade.php.
| Directory | Views |
|---|
layouts/ | app.blade.php, sidebar.blade.php |
auth/ | login.blade.php |
dashboard/ | administrador/, mesero/, cocinero/, cajero/ (index + reportes each) |
productos/ | index, create, edit, show |
inventario/ | index |
mesas/ | index |
pedidos/ | index |
comandas/ | index |
delivery/ | index |
facturas/ | index |
pagos/ | index |
cierres/ | index |
usuarios/ | index, create, edit, show |
routes/web.php
All web routes for the application. Public routes include / and /inicio (home page). All other routes sit inside an auth middleware group, with most also guarded by RoleMiddleware. See Routes for the full route table.
routes/auth.php is included via require __DIR__.'/auth.php' at the bottom of web.php. It is generated by Laravel Breeze and handles login, logout, and registration endpoints.
Design color palette
The UI is built with Tailwind CSS using the following CSS custom properties:
:root {
--primary: #1E3A8A; /* blue-800 */
--secondary: #3B82F6; /* blue-500 */
--accent: #60A5FA; /* blue-400 */
--background: #F9FAFB; /* gray-50 */
--surface: #FFFFFF; /* white */
--text: #111827; /* gray-900 */
--muted: #6B7280; /* gray-500 */
--border: #E5E7EB; /* gray-200 */
}
Autoloading
PSR-4 autoloading is configured in composer.json:
| Namespace | Directory |
|---|
App\ | app/ |
Database\Factories\ | database/factories/ |
Database\Seeders\ | database/seeders/ |
Tests\ | tests/ |
Run composer dump-autoload after adding new classes outside the standard directories to refresh the autoloader map.
