Descripción del Proyecto
E-commerce híbrido: xBase++ Desktop + Laravel Web - Integración con sistemas legacy
⚠️ Sistema HÍBRIDO único que integra un ERP desktop xBase++ (con archivos DBF) con una capa e-commerce Laravel. NO es 100% Laravel - es una solución especializada para empresas con sistemas legacy en producción. Ideal para negocios con sistema desktop funcionando hace años (ej: 50.000 productos en DBF) que quieren agregar ventas online SIN migrar todo el sistema. El desktop xBase++ sigue manejando TODO el negocio (inventario, compras, ventas, clientes, proveedores), Laravel solo es la "vidriera web" que lee datos sincronizados. Incluye: sincronización inteligente DBF→MySQL→Laravel, panel admin web limitado (solo imágenes/contenido, NO productos), integración Google Gemini AI para generación de contenido SEO, estrategia de contenido visual flexible (imagen obligatoria, texto opcional), sistema de imágenes avanzado (múltiples por producto, 2 tamaños automáticos), e-commerce completo con MercadoPago, tabla DESCARTI para compatibilidad con sucursales legacy, y SweetAlert2 en todo el sistema. Perfecto para ferreterías, comercios multi-sucursal, o cualquier negocio con personal acostumbrado a su sistema desktop que necesita canal web adicional SIN disrupciones.
Características Principales
⚠️ ARQUITECTURA HÍBRIDA ÚNICA
→ Sistema Desktop xBase++: Gestión principal
→ Laravel Web Layer: Solo e-commerce
→ Sincronización: DBF → MySQL → Laravel
→ NO es 100% Laravel
🔄 Sincronización Inteligente
→ Desktop publica a MySQL periódicamente
→ Laravel lee en tiempo real
→ Modelos mapean estructura DBF
→ Stock (CO_ARTI), Categweb (CO_CATEGOR)
→ Campos UPPERCASE: DBF, lowercase: Laravel
🎛️ Panel Admin Web Limitado
→ NO gestiona productos/inventario
→ SÍ gestiona: imágenes de productos
→ Contenido: páginas, blog, FAQs
→ Sliders y banners
→ Configuración MercadoPago
→ SEO y meta tags
🎨 Estrategia de Contenido Visual Flexible
→ Solo imagen obligatoria, resto opcional
→ Cliente A: Todo diseñado en imagen
→ Cliente B: Texto HTML superpuesto (SEO)
→ Cliente C: Enfoque mixto
→ internal_name para identificación
→ display_name inteligente
→ Un sistema para TODOS los clientes
🤖 Integración AI (Gemini)
→ AI SEO Generation automática
→ Meta title, description, keywords
→ Blog posts, categorías, FAQs, sliders
→ Retry automático con modelos diferentes
→ AI Content Writer: generación completa
→ Prompts contextuales inteligentes
🖼️ Sistema de Imágenes Avanzado
→ Múltiples imágenes por producto
→ Dos tamaños automáticos
→ Large: 1400px (detalle)
→ Small: 300x300px (thumbnails)
→ Naming: {product_id}-{image_id}-{timestamp}
→ Upload desde admin, asociadas a productos DBF
🛒 E-commerce Completo
→ Catálogo: Categorías → Subcategorías → Productos
→ Shopping cart con descuentos
→ Checkout: validación estricta
→ Pagos: MercadoPago integrado
→ Órdenes: se envían al desktop
🔔 SweetAlert2 en TODO el Sistema
→ Reemplazo de alert() y confirm() nativos
→ Notificaciones toast del servidor
→ Confirmaciones estilizadas
→ Consistencia admin + frontend
📘 Tabla DESCARTI (Caso Especial)
→ DESCripción de ARTÍculos (no descartados!)
→ Compatibilidad con sucursales legacy
→ Clientes SIN sucursales: usa Stock.DE_ARTI
→ Clientes CON sucursales: usa DESCARTI
→ sincronizarConStock() mantiene ambas
🔑 Estructura de Claves (CRÍTICO)
→ Sistema jerárquico con claves compuestas
→ categweb: CO_CATEGOR (1 campo)
→ subcaweb: CO_CATEGOR + CO_SUBCATE (2)
→ varieweb: + CO_VARIEDA (3 campos)
→ ID_RECORD: Laravel, CO_*: negocio real DBF
📈 Mejoras en Administración
→ Blog con categorías y SEO
→ FAQs organizados por categoría
→ Páginas estáticas editables
→ Sliders/banners con IA
→ Meta tags personalizados
→ URLs amigables (slugs)
→ Sitemap automático
✅ CASOS DE USO ESPECÍFICOS
→ Ferretería - 20 años con sistema desktop
→ Catálogo - 50.000 productos en DBF
→ E-commerce - SIN migrar todo el sistema
→ Multi-sucursal - sistema central compartido
→ Personal capacitado - siguen usando desktop
→ Canal adicional - web para clientes, desktop para gestión
⚠️ CONVENCIONES CRÍTICAS
→ Stock NO Product
→ StockImage NO ProductImage
→ Categweb NO Category
→ Marca NO Brand
→ Flags: S/N no true/false
→ Sin timestamps en legacy
