⚡ MV SQL NLP

🌎 Idiomas: Español · English · Português

Tu base de datos, en tu idioma. Consultá cualquier base SQL en lenguaje natural (español, inglés o portugués), sin saber una línea de código. La IA genera SQL profesional optimizado con CTEs, lo valida contra tu esquema real, te muestra el intervalo de confianza de cada respuesta y devuelve tablas, gráficos y análisis exportables a Excel, CSV, PDF y HTML.

📦 Qué hay en este repositorio

Carpeta	Qué es
web/	Landing comercial (estilo SaaS dark) lista para Vercel — 3 idiomas (ES/EN/PT), demo animada, precios con MercadoPago
desktop/	Programa de PC profesional (Electron + React) con instalador NSIS .exe para Windows
app-python/	Versión autoinstalable (INICIAR_MVSQL.bat): un doble clic instala todo y abre la app (Streamlit)
docs/	Plan de negocio y modelo financiero, material de venta en 3 idiomas (guion de demo, propuesta, one-pager), checklist de despliegue, integración MercadoPago

✨ Funciones principales

• 💬 Lenguaje natural → SQL en ES/EN/PT, con JOINs correctos según las relaciones reales del esquema
• 🤖 IA a elección del cliente: Claude, GPT, Copilot (Azure OpenAI), Gemini, Groq, Mistral, DeepSeek, Grok, Ollama local (gratis) o cualquier endpoint OpenAI-compatible — con API key propia o con créditos facturados por nosotros
• 🗄️ Multi-base: SQL Server, MySQL/MariaDB, PostgreSQL y SQLite — se adapta a cualquier esquema sin configuración
• 📄 Modo Archivo: consultá un CSV, Excel o Parquet sin tener base de datos — carga rápida con caché
• 🔢 Formato a medida: menú de decimales, separador de miles, % y moneda ($U, US$, AR$, R$, €…) aplicado a tablas, gráficos y análisis
• 🧩 Conector MCP: CONECTAR_CLAUDE_MCP.bat conecta tu Claude Desktop directo a tu base (SQL Server/MySQL/PostgreSQL/SQLite) vía MCP
• 🚀 Optimización con CTE: consultas estructuradas con WITH … AS, filtros tempranos, sin SELECT *; re-optimizador de SQL existente
• 📐 Intervalo de confianza en cada respuesta (ej. 92% ±5), combinando autoevaluación del modelo, señal RAG y validación estructural
• 🛡️ Anti-alucinación: el SQL se valida contra el catálogo real; si algo no existe se rechaza y se auto-corrige (self-repair)
• 🔒 Seguridad: conexión read-only, solo SELECT/WITH. Para generar el SQL viaja el esquema (nombres de tablas/columnas) con unos pocos valores de ejemplo de las columnas de texto; el análisis escrito usa una muestra de hasta 20 filas del resultado. El modo privacidad estricta manda solo nombres (ni ejemplos ni filas), y con Ollama local no sale nada de tu máquina (invariantes cubiertos por tests/test_privacidad.py)
• 👥 Equipo y permisos: cada usuario entra con su PIN y ve solo las tablas de su rol — la IA ni se entera de que existen las demás
• 🛡️ Auditoría: quién consultó qué, cuándo, con qué SQL y con qué resultado — exportable a CSV para cumplimiento
• ⭐ Consultas guardadas con nombre + conversión a stored procedures de producción
• 📓 Cuadernos: informes reutilizables que mezclan Markdown, preguntas y SQL con variables compartidas ({{mes}}, {{sucursal}}) — se corren enteros cambiando un valor, y se exportan a Markdown

🚀 Inicio rápido

Versión autoinstalable (Windows, 2 minutos): entrá a app-python/ y hacé doble clic en INICIAR_MVSQL.bat. Instala Python/dependencias, genera una base demo y abre la app en http://localhost:8791 (puerto fijo, para no chocar con otras apps que tengas corriendo en tu PC).

⚠️ Si ya habías descargado una copia vieja del programa (por ejemplo, del zip de ejemplo original), volvé a descargarla — las versiones viejas tenían un bug conocido de pandas al mostrar columnas de fecha (AssertionError en pd.to_datetime), ya corregido acá.

App de escritorio (desarrollo):

cd desktop && npm install && npm run dev      # desarrollo
npm run dist                                   # instalador .exe (Windows)

Web (Vercel): importar el repo en Vercel con Root Directory = web/ (es un sitio estático, sin build).

✅ Correr los tests (en una máquina limpia)

Sin instalar nada del proyecto, con git y node (18+) alcanza para los tests de web/; si además hay python3 en el PATH corre también los del motor NL-a-SQL (app-python/tests/ no necesita ningún paquete de requirements.txt, solo la biblioteca estándar):

git clone https://github.com/vieraschiavi/Mv-Sql.git
cd Mv-Sql
npm ci        # solo instala lo de web/ (jsonwebtoken, mercadopago, jszip…)
npm test      # descubre y corre TODO: web/tests/*.test.js + app-python/tests/test_*.py

Sale con código de salida distinto de cero si algo falla — es lo que corre .github/workflows/tests.yml en cada push. Para correr un subconjunto: npm test -- --web o npm test -- --python.

💰 Modelo comercial

El servicio es el negocio; el producto es el diferenciador.

Qué	Precio	Cómo se cobra
Implementación sobre tu BD/ERP	US$ 2.500 (Express US$ 900)	pago único
Licencia mensual	US$ 15 / 29 / 79	suscripción (MercadoPago preapproval)
Soporte y mantenimiento	US$ 150/mes	suscripción
Créditos de IA embebidos	US$ 9 / 35 / 110	pago único

Prueba completa de 7 días sin tarjeta. Análisis de mercado, competencia y escenarios de rentabilidad en docs/PLAN_DE_NEGOCIO.md; modelo financiero ejecutable en docs/MODELO_NEGOCIO.py. Checklist de puesta en producción en docs/DESPLIEGUE.md.