SISTEMA DE SUPERMERCADOS Y TIENDAS V3.0
========================================

DESCRIPCIÓN:
Sistema completo de autoservicio para supermercados con lector de código de barras,
carrito de compras dinámico y panel de administración con roles diferenciados.

TECNOLOGÍAS:
- Backend: PHP 8.1
- Base de Datos: MySQL 8.0
- Frontend: HTML5, CSS3, JavaScript (Vanilla)
- Librerías: Chart.js, HTML5-QRCode

CARACTERÍSTICAS PRINCIPALES:

MÓDULO CLIENTE:
✓ Autenticación por cédula/RUC
✓ Registro automático de nuevos clientes
✓ Dashboard interactivo con dos paneles
✓ Lector de código de barras con cámara
✓ Carrito de compras en tiempo real
✓ Historial de compras
✓ Promociones rotativas cada 10 segundos
✓ Feedback sonoro al agregar productos
✓ Responsive para tablets y móviles
✓ Formato de moneda en Guaraníes

PANEL DE ADMINISTRACIÓN:
✓ Dashboard con gráficos interactivos
✓ Sistema de roles (Administrador, Comercial, Colaborador)
✓ Gestión completa de productos (CRUD)
✓ Gestión de clientes
✓ Gestión de promociones
✓ Mensajes emergentes para clientes
✓ Reportes de ventas
✓ Interfaz moderna y agradable

CREDENCIALES POR DEFECTO:
- Usuario Admin: Tiendas
- Contraseña: 2025

BASE DE DATOS:
- Nombre: tiendabd
- Usuario: tiendas2025
- Contraseña: product@s.py

ESTRUCTURA:
- /admin/ - Panel de administración
- /cliente/ - Módulo de clientes
- /config/ - Configuración del sistema
- /assets/ - Recursos (CSS, JS, imágenes)
- /uploads/ - Archivos subidos
- /logs/ - Logs del sistema

ARCHIVOS IMPORTANTES:
- index.php - Página principal
- database_setup.sql - Script de base de datos
- README.md - Documentación completa
- GUIA_INSTALACION.md - Guía de instalación

REQUISITOS:
- PHP 7.4+
- MySQL 8.0+
- Apache 2.4+ o Nginx
- Extensiones: pdo, pdo_mysql, mbstring, gd

INSTALACIÓN RÁPIDA:
1. Importar database_setup.sql
2. Configurar Apache/Nginx
3. Dar permisos a uploads/ y logs/
4. Acceder a http://localhost/

URL DEMO:
https://80-i85tgjzrx0fnpmn1gfeyj-1adeaea7.manusvm.computer

ESTADO: ✅ COMPLETO Y FUNCIONAL
