Resumen Ejecutivo

GNL CRM es una aplicación web de gestión comercial para Gas Natural Licuado, construida como Single Page Application (SPA) con las siguientes tecnologías:

• Backend: Node.js + Express 5.x (API REST)
• Base de datos: SQLite 3 con better-sqlite3 v12 (modo WAL)
• Frontend: HTML5 + CSS3 + JavaScript vanilla (sin frameworks)
• Mapas: Leaflet.js 1.9 con teselas OpenStreetMap (mapa mundial interactivo en dashboard)
• Autenticación: Sesiones HTTP con express-session (almacenadas en memoria)

Requisitos del Servidor

Pasos de Despliegue

# 1. Clonar el repositorio
git clone <repositorio> gnl-crm
cd gnl-crm

# 2. Instalar dependencias
npm install

# 3. Arrancar el servidor
node server.js
# → Servidor escuchando en http://localhost:3000

El servidor crea automáticamente la base de datos SQLite y el usuario admin por defecto en el primer arranque.

Integración en Ecosistema Microsoft

Azure App Service

Despliegue recomendado en la nube de Microsoft. Plan B1 o superior. Compatible con despliegue continuo desde GitHub/Azure DevOps.

Azure SQL

Migración opcional de SQLite a SQL Server / Azure SQL para entornos de producción con alta concurrencia. El esquema es compatible con mínimas adaptaciones.

Power BI

Conexión directa a la base de datos (SQLite vía ODBC o Azure SQL nativo) para crear dashboards avanzados con KPIs comerciales, mapas geográficos y análisis de pipeline.

Power Apps

Posibilidad de consumir la API REST del CRM desde Power Apps para crear interfaces móviles personalizadas para comerciales en campo.

Power Automate

Automatización de flujos de trabajo:

• Alertas automáticas de expiración de NDA
• Notificaciones de nuevas oportunidades
• Seguimiento periódico de contactos
• Generación automática de informes semanales

Microsoft 365

Integración con Outlook para envío de correos desde el CRM y con Teams para notificaciones de canal sobre actividad comercial.

Plan de Despliegue Recomendado

Seguridad y Mantenimiento

• Contraseñas: Almacenadas en texto plano — se recomienda añadir bcrypt antes del despliegue en producción
• Sesiones: Gestionadas en memoria del servidor (se pierden al reiniciar)
• CORS: Habilitado globalmente (cors()) — restringir a dominio propio en producción
• Backups: Copiar el fichero crm.db periódicamente (también se genera crm.db.backup automáticamente)
• Actualizaciones: npm audit periódico para vulnerabilidades
• Logs: Salida estándar (stdout), se recomienda PM2 o similar para producción

Acceso al Sistema

Accede a la aplicación desde tu navegador introduciendo la URL proporcionada por el equipo IT. Introduce tu usuario y contraseña en la pantalla de login.

Dashboard

La pantalla principal muestra un resumen visual del CRM:

• Tarjetas resumen: Número total de entidades, contactos, oportunidades, documentos y países. Haz clic en cualquier tarjeta para ir directamente a su gestión.
• Mapa mundial interactivo: Muestra la distribución geográfica de las entidades. Cada círculo representa un país; su tamaño es proporcional al número de entidades. Pasa el ratón sobre un círculo para ver el detalle y haz clic para buscar las entidades de ese país. Los códigos de país siguen el estándar ISO 3166-1 alpha-3 (ESP, USA, IND…). El territorio virtual LNG no aparece en el mapa al no tener coordenadas geográficas.
• Gráficos de barras: Entidades por región, por tipo, oportunidades por timing y contactos por probabilidad. Haz clic en una barra para filtrar la tabla por ese valor.

Buscar Entidades

El buscador global permite encontrar entidades por nombre, código, región, tipo o país. Escribe en el campo de búsqueda y los resultados se filtran en tiempo real.

Desde los resultados, pulsa "Ver" para acceder al detalle completo de la entidad con sus contactos, oportunidades y documentos asociados.

Gestión de Tablas (CRUD)

Cada tabla de gestión (Entidades, Contactos, Oportunidades, Documentos, Países) ofrece las mismas operaciones:

Detalle de Entidad

Al hacer clic en "Ver" desde la búsqueda o la tabla de entidades, se muestra la ficha completa de la entidad con:

• Datos generales: Región, país, códigos fiscales, dirección, comentarios
• Botón Editar: Permite modificar los campos directamente en la ficha
• Pestañas: Contactos, Oportunidades y Documentos asociados
• Desde cada pestaña puedes añadir, editar o eliminar registros vinculados a esa entidad

Importación Excel

Permite cargar datos masivamente desde un archivo Excel (.xlsx). El archivo debe contener las siguientes hojas con sus columnas correspondientes:

Asistente IA

El botón en la esquina inferior derecha abre el asistente de inteligencia artificial, que consulta datos reales de la base de datos. Tipos de consulta soportados:

• Por país: "India", "Brasil" — muestra entidades y oportunidades del país
• Documentos: "NDA", "documentos" — estado de documentación legal
• Oportunidades: "pipeline", "oportunidades" — resumen del pipeline comercial
• Próximos pasos: "acciones", "próximos pasos" — acciones pendientes
• Contactos: "seguimiento", "contactos" — estado de contactos
• Resumen: "dashboard", "resumen" — resumen ejecutivo global

Gestión de Usuarios Solo Admin

Los administradores pueden crear nuevos usuarios desde el menú "Usuarios". Cada usuario tiene: nombre de usuario, contraseña, nombre visible y rol (admin o user).

Tecnología

• Motor: SQLite 3 mediante la librería better-sqlite3 (síncrona, rápida)
• Modo WAL: Activado para mejor rendimiento en lecturas concurrentes
• Foreign Keys: Habilitadas (PRAGMA foreign_keys = ON)
• Archivo: crm.db en la raíz del proyecto

Diagrama de Relaciones

 ┌─────────┐       ┌──────────────┐       ┌─────────────┐
 │  Pais   │──1:N──│  Entidades   │──1:N──│  Contactos  │
 └─────────┘       │              │       └─────────────┘
                   │              │──1:N──┌─────────────────┐
                   │              │       │  Oportunidades  │
                   │              │       └─────────────────┘
                   │              │──1:N──┌──────────────┐
                   └──────────────┘       │  Documentos  │
                                          └──────────────┘

 ┌────────────┐
 │  Usuarios  │  (tabla independiente)
 └────────────┘

Tabla: Pais

Tabla: Entidades

Tabla: Contactos

Tabla: Oportunidades

Tabla: Documentos

Tabla: Usuarios

Migraciones Automáticas

Los códigos de contactos, oportunidades y documentos se generan automáticamente al crear registros sin código:

API REST — Endpoints

Dependencias npm