Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/lffiesco-svg/gastromovil/llms.txt

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

GastroMóvil is an end-to-end food delivery web application built with Django and Django Channels. It connects customers, restaurant owners, and delivery drivers through a unified platform featuring real-time WebSocket notifications, an AI chatbot powered by Groq’s Llama 3.3 model, and a REST API secured with JWT authentication.

Introduction

Learn what GastroMóvil does, its architecture, and the roles it supports.

Quickstart

Clone the repo, configure environment variables, and run locally in minutes.

Deployment

Deploy GastroMóvil to Railway with Daphne, MySQL, and Cloudinary.

API Reference

Explore the REST API: JWT auth, orders, products, restaurants, and more.

Platform Overview

GastroMóvil is built around three user roles that interact through a shared order lifecycle:

Clients

Browse restaurants, add items to cart, place orders, and track deliveries in real time.

Restaurants

Manage menus, accept incoming orders, and update order status from a dedicated dashboard.

Delivery Drivers

Receive order assignments via WebSocket and share live GPS location with customers.

Key Features

Real-Time Orders

Order status changes are pushed instantly via Django Channels WebSockets — no polling required.

AI Chatbot

A LangChain + Groq chatbot answers menu questions and recommends dishes using live product data.

REST API

JWT-authenticated API endpoints for all resources — suitable for mobile or third-party clients.

WebSockets

Two WebSocket channels: order notifications and live driver location streaming.

Getting Started

1

Clone the repository

git clone https://github.com/lffiesco-svg/gastromovil.git
cd gastromovil
2

Configure environment variables

Copy the required environment variables and fill in your database, email, Cloudinary, and API credentials. See Environment Variables for the full list.
3

Install dependencies and run migrations

pip install -r requirements.txt
python manage.py migrate
4

Start the ASGI server

daphne -b 0.0.0.0 -p 8000 gastromovil.asgi:application
Visit http://localhost:8000 to see the platform running.

Build docs developers (and LLMs) love