Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/teofilobetancourt/Tradiciones-y-Sabores/llms.txt

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

Tradiciones y Sabores is an all-in-one restaurant management platform built for operators who need a single cohesive system covering every aspect of their operation — from front-of-house point of sale to back-of-house inventory control. The system is built on a three-layer Docker architecture (React 19 + FastAPI + PostgreSQL 16) and can be up and running in minutes with Docker Compose.

Introduction

Learn what Tradiciones y Sabores is, who it’s for, and what problems it solves.

Architecture

Understand the three-layer Docker stack and how the components interact.

Deploy with Docker

Get the full system running locally or on a VPS with Docker Compose.

API Reference

Explore the FastAPI REST endpoints powering every module.

System Modules

Point of Sale

Take orders, apply IVA, and print tickets at the counter.

Customer Menu

Digital self-service menu with real-time order tracking for guests.

Kitchen Display

KDS board with audio alerts for kitchen staff to manage active orders.

Order Management

Full order history with multi-field search and status management.

Inventory

Stock control with low-inventory alerts and reorder points.

Reports

KPI dashboard with revenue, order counts, and trend comparisons.

Quick Start

1

Clone the repository

git clone https://github.com/teofilobetancourt/Tradiciones-y-Sabores.git
cd Tradiciones-y-Sabores
2

Configure environment variables

Copy the example file and set your database credentials:
cp .env.example .env
3

Start all services

Launch the full three-layer stack with a single command:
docker compose up --build -d
4

Access the system

InterfaceURL
Staff applicationhttp://localhost
Customer menuhttp://localhost/?view=menu
API documentationhttp://localhost:5000/api/docs
On first boot the backend automatically creates all database tables and seeds the catalog with sample dishes, tables, a default client, inventory items, and a sample supplier.

Build docs developers (and LLMs) love