Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/FloresJesus/SS_RESTAURANT/llms.txt

Use this file to discover all available pages before exploring further.

The menu system in SS Restaurant is organised into two layers: categories (categoria_producto) and products (producto). Admins manage the full catalogue through the dashboard — creating categories, adding and editing products, uploading images to ImageKit, and toggling availability in real time. Authenticated staff can read all products; the unauthenticated public endpoint only exposes items that are currently available.

​
Category management

Categories group related products on the menu display. The full category list is readable by any authenticated user; only admin may create, update, or delete categories.
MethodPathAuth
GET/api/menu/categoriasAny role
POST/api/menu/categoriasadmin only
Creating a category: 
POST /api/menu/categorias
Content-Type: application/json

{
  "nombre": "Bebidas Calientes"
}
Response (201): 
{
  "message": "Categoria creada correctamente",
  "id": 8
}
Category names must be unique. Attempting to create a duplicate returns 400 La categoria ya existe. Sample category list response: 
[
  { "id": 1, "nombre": "Entradas" },
  { "id": 2, "nombre": "Platos de fondo" },
  { "id": 3, "nombre": "Bebidas" },
  { "id": 8, "nombre": "Bebidas Calientes" }
]

​
Product management

Products are the individual menu items ordered by customers.
MethodPathAuth
GET/api/menuAny authenticated role
POST/api/menuadmin only
PUT/api/menu/:idadmin only
DELETE/api/menu/:idadmin only
Creating a product: 
POST /api/menu
Content-Type: application/json

{
  "nombre": "Lomo Saltado",
  "precio": 65.00,
  "categoria_id": 2,
  "descripcion": "Clásico salteado de lomo fino con papas fritas y arroz",
  "disponible": true,
  "imagen_url": null
}
FieldRequiredDescription
nombre✅Product name
precio✅Price in Bolivianos
categoria_idOptionalMust reference an existing category; null = uncategorised
descripcionOptionalDisplayed on product cards
disponibleOptionalDefaults to true
imagen_urlOptionalFull URL returned by the upload endpoint
Full product object as returned by the API: 
{
  "id": 12,
  "categoria_id": 2,
  "categoria_nombre": "Platos de fondo",
  "nombre": "Lomo Saltado",
  "descripcion": "Clásico salteado de lomo fino con papas fritas y arroz",
  "precio": "65.00",
  "imagen_url": "https://ik.imagekit.io/yourproject/RestauranteSS/menu/1720000000_lomo.jpg",
  "disponible": true,
  "creado_en": "2025-01-15T14:32:00.000Z"
}

​
Image uploads

Product images are stored on ImageKit under the folder /RestauranteSS/menu/. Upload before creating or updating a product, then pass the returned URL as imagen_url. 
POST /api/menu/upload
Authorization: Bearer <token>
Content-Type: multipart/form-data

image: <file>
Constraints enforced by the server:
  • Only MIME types starting with image/ are accepted.
  • Maximum file size: 3 MB.
  • The multer field name must be image (case-sensitive).
Response (201): 
{
  "imageUrl": "https://ik.imagekit.io/yourproject/RestauranteSS/menu/1720000000_lomo_saltado.jpg",
  "path": "https://ik.imagekit.io/yourproject/RestauranteSS/menu/1720000000_lomo_saltado.jpg",
  "fileId": "abc123def456"
}
Store the path value as the imagen_url on the product record.
The upload route (POST /api/menu/upload) requires admin role. Uploading without the correct role returns 403 Forbidden.

​
Availability toggle

Each product has a boolean disponible field. Setting it to false hides the product from the public menu endpoint without deleting it. Staff can see all products regardless of availability via GET /api/menu. The Vue dashboard provides a one-click Agotar / Activar toggle on every product card which calls PUT /api/menu/:id with the flipped disponible value while preserving all other fields. 
PUT /api/menu/12
Content-Type: application/json

{
  "nombre": "Lomo Saltado",
  "precio": 65.00,
  "categoria_id": 2,
  "descripcion": "Clásico salteado de lomo fino con papas fritas y arroz",
  "disponible": false
}
Use the availability toggle at the end of the night when an ingredient runs out rather than deleting the product. The product reappears on the public menu as soon as disponible is set back to true.

​
Public menu endpoint

The public menu is available without authentication and is intended for customer-facing displays or the restaurant’s website. 
GET /api/public/menu
This endpoint returns only products with disponible = true along with the full category list. No authentication header is required. Response shape: 
{
  "products": [
    {
      "id": 12,
      "categoria_id": 2,
      "categoria_nombre": "Platos de fondo",
      "nombre": "Lomo Saltado",
      "descripcion": "Clásico salteado de lomo fino con papas fritas y arroz",
      "precio": "65.00",
      "imagen_url": "https://ik.imagekit.io/yourproject/RestauranteSS/menu/1720000000_lomo.jpg",
      "disponible": true,
      "creado_en": "2025-01-15T14:32:00.000Z"
    }
  ],
  "categories": [
    { "id": 1, "nombre": "Entradas" },
    { "id": 2, "nombre": "Platos de fondo" }
  ]
}

Build docs developers (and LLMs) love

Get started for freeTalk to us