faraon1979/tpv-elite-api repository overview

🚀 TPV Elite Bar - Backend (API)

Este repositorio contiene la API / Backend de TPV Elite Bar, un sistema de punto de venta premium y dinámico para hostelería diseñado para funcionar completamente en Docker.

🛠️ Instalación Completa (Base de Datos + API + Frontend)

Para instalar el TPV completo en cualquier ordenador con Docker y Docker Compose instalados, sigue estos pasos.

📁 1. Crear la carpeta del proyecto

Crea una carpeta donde se almacenarán los datos persistentes del TPV.

Ejemplos:

Windows: C:\TPV Linux: ~/tpv

Después entra dentro de la carpeta.

⚙️ 2. Crear el archivo .env

Dentro de la carpeta del proyecto, crea un archivo llamado .env con el siguiente contenido:

DB_USER=tpv_user
DB_PASSWORD=tpv_password
DB_NAME=tpv_bar
PORT=4001
VITE_API_URL=http://localhost:4001

🐳 3. Crear el archivo docker-compose.yml

Dentro de la misma carpeta, crea un archivo llamado docker-compose.yml y pega este contenido:

services:
  db:
    image: postgres:15-alpine
    container_name: tpv_db
    environment:
      POSTGRES_USER: ${DB_USER}
      POSTGRES_PASSWORD: ${DB_PASSWORD}
      POSTGRES_DB: ${DB_NAME}
    volumes:
      - ./postgres_data:/var/lib/postgresql/data
    ports:
      - "5432:5432"
    restart: always

  api:
    image: faraon1979/tpv-elite-api:latest
    container_name: tpv_api
    depends_on:
      - db
    environment:
      - DATABASE_URL=postgresql://${DB_USER}:${DB_PASSWORD}@db:5432/${DB_NAME}?schema=public
      - ROOT_PATH=/app_root
    ports:
      - "4001:4001"
    volumes:
      - ./backups:/app/backups
      - ./.env:/app/.env
      - ./:/app_root
      - /var/run/docker.sock:/var/run/docker.sock
    restart: always

  app:
    image: faraon1979/tpv-elite-app:latest
    container_name: tpv_app
    depends_on:
      - api
    ports:
      - "5173:5173"
    volumes:
      - ./.env:/app/.env
    restart: always

networks:
  default:
    driver: bridge
    driver_opts:
      com.docker.network.driver.mtu: 1280

▶️ 4. Iniciar el TPV

Desde una terminal abierta dentro de la carpeta del proyecto, ejecuta:

docker compose up -d

Docker descargará automáticamente:

PostgreSQL

API Backend

Frontend TPV

Y dejará todo funcionando automáticamente.

🌐 Acceso al sistema

Una vez iniciado:

Servicio URL

TPV Frontend http://localhost:5173⁠

API Backend http://localhost:4001⁠

💾 Persistencia de datos

Toda la información importante se almacena localmente:

./postgres_data → Base de datos PostgreSQL

./backups → Copias de seguridad

Esto permite actualizar los contenedores sin perder datos.

🔄 Actualizar a la última versión

docker compose pull
docker compose up -d

🛑 Detener el sistema

docker compose down

📦 Requisitos

Docker

Docker Compose

⚡ Características

Instalación automática

Backend + Frontend + Base de Datos

Persistencia de datos

Actualizaciones simples

Preparado para hostelería

Arquitectura Docker completa

Compatible con Linux y Windows