📋 Gestor de Pedidos

Una aplicación web moderna desarrollada con Flask para crear y gestionar pedidos de productos con exportación automática a Excel.

✨ Características

• 🎨 Interfaz Moderna: Diseño limpio y profesional con gradientes y animaciones
• 🔍 Búsqueda Inteligente: Autocompletado dinámico para selección de productos
• 📊 Exportación Excel: Genera archivos .xlsx con formato profesional automáticamente
• 📱 Responsive Design: Optimizado para dispositivos móviles y desktop
• ⚡ Gestión Dinámica: Añadir/eliminar productos con animaciones suaves
• 💰 Cálculo Automático: Precios y totales actualizados en tiempo real

🛠️ Tecnologías

Backend

• Python 3.8+
• Flask - Framework web minimalista
• Pandas - Manipulación de datos
• OpenPyXL - Generación de archivos Excel

Frontend

• HTML5 & CSS3 - Estructura y estilos modernos
• JavaScript ES6+ - Interactividad y dinamismo
• Font Awesome - Iconografía
• Google Fonts (Inter) - Tipografía moderna
• Awesomplete - Autocompletado inteligente

🚀 Instalación Rápida

Desarrollo Local

# Clonar el repositorio
git clone https://github.com/tu-usuario/gestor-de-productos.git
cd gestor-de-productos

# Crear entorno virtual
python -m venv venv

# Activar entorno virtual
# Windows:
venv\Scripts\activate
# macOS/Linux:
source venv/bin/activate

# Instalar dependencias
pip install -r requirements.txt

# Configurar variables de entorno
cp .env.example .env
# Editar .env con tus configuraciones

# Ejecutar aplicación (desarrollo)
python app.py

Producción

Opción 1: Servidor Local

# Windows
start_production.bat

# Linux/macOS
chmod +x start_production.sh
./start_production.sh

Opción 2: Docker

# Construir y ejecutar
docker-compose up --build

# En segundo plano
docker-compose up -d --build

Opción 3: Manual con Gunicorn

# Instalar dependencias
pip install -r requirements.txt

# Ejecutar con Gunicorn
gunicorn --config gunicorn.conf.py wsgi:app

Visita http://127.0.0.1:5000 en tu navegador.

📁 Estructura del Proyecto

gestor-de-productos/
├── 📄 app.py                 # Aplicación Flask principal
├── 📋 productos.json         # Catálogo de productos
├── 📦 requirements.txt       # Dependencias Python
├── 📁 static/
│   └── 🎨 css/
│       └── style.css         # Estilos modernos
└── 📁 templates/
    └── 🌐 index.html         # Interfaz principal

⚙️ Configuración

Personalizar Catálogo

Edita productos.json para gestionar tu inventario:

[
    {
        "nombre": "Producto Ejemplo",
        "precio": 29.99
    },
    {
        "nombre": "Otro Producto",
        "precio": 15.50
    }
]

🎯 Funcionalidades Destacadas

📊 Exportación Excel Profesional

• Tablas con formato automático
• Cálculos de totales
• Estilos corporativos
• Nombres de archivo únicos con timestamp

🔍 Búsqueda Inteligente

• Autocompletado en tiempo real
• Filtrado por coincidencias parciales
• Navegación por teclado
• Actualización automática de precios

📱 Diseño Responsivo

• Adaptable a móviles y tablets
• Animaciones CSS suaves
• Interfaz táctil optimizada
• Gradientes y efectos modernos

🤝 Contribuir

¡Las contribuciones son bienvenidas! Para cambios importantes:

1. Fork el proyecto
2. Crea una rama para tu feature (git checkout -b feature/AmazingFeature)
3. Commit tus cambios (git commit -m 'Add some AmazingFeature')
4. Push a la rama (git push origin feature/AmazingFeature)
5. Abre un Pull Request

📝 Licencia

Este proyecto está bajo la Licencia MIT. Ver LICENSE para más detalles.

👨‍💻 Autor

Desarrollado con ❤️ para optimizar la gestión de pedidos empresariales.

---

⭐ ¡No olvides dar una estrella si este proyecto te fue útil!