Tiendas Mi Cholo es un sistema de gestión comercial completo, construido con Angular 22 en el frontend y Spring Boot 3.3.4 en el backend. Permite a equipos de tiendas registrar ventas, gestionar órdenes de compra, controlar el inventario en tiempo real y generar reportes PDF, todo protegido por autenticación JWT con control de acceso basado en roles (ADMIN, VENDEDOR, ALMACENERO).Documentation Index
Fetch the complete documentation index at: https://mintlify.com/interezante456-pixel/Miercoles-Proyecto/llms.txt
Use this file to discover all available pages before exploring further.
Inicio Rápido
Levanta el sistema completo en minutos con Docker Compose y realiza tu primera llamada a la API.
Autenticación
Aprende cómo obtener tokens JWT y cómo enviarlos en cada petición protegida.
Módulos Principales
Explora el dashboard, productos, ventas, compras e inventario desde la interfaz web.
API Reference
Documentación completa de los 39 endpoints REST: parámetros, cuerpos de solicitud y respuestas.
¿Qué incluye el sistema?
Ventas
Registra boletas, facturas y tickets con descuento por ítem e IGV automático.
Compras
Crea órdenes de compra a proveedores y actualiza el stock al recibirlas.
Inventario
Rastrea cada movimiento de stock: entradas, salidas y ajustes con trazabilidad completa.
Productos
Catálogo con código, precio, stock mínimo, categoría y alertas de stock bajo.
Reportes PDF
Genera reportes de ventas e inventario en PDF descargables directamente desde la API.
Despliegue Docker
Stack completo con Docker Compose: MySQL 8, phpMyAdmin y backend pre-configurados.
Comenzar en 3 pasos
Levanta la base de datos
Ejecuta
docker-compose up -d desde la raíz del repositorio para iniciar MySQL 8 con el schema y datos iniciales cargados automáticamente.Inicia el backend
Desde la carpeta
backend/, ejecuta ./mvnw spring-boot:run. El servidor arranca en http://localhost:8080/api.El frontend Angular corre en
http://localhost:4200 con ng serve. El CORS del backend ya está pre-configurado para este origen.