Arquitectura del sistema
Esta página presenta Nadigit IMS componente por componente: qué hace cada uno y cómo colaboran. Está dirigida a administradores de sistemas e integradores que preparan una instalación o una integración. La instalación se describe en Instalación.
Vista general
Todos los componentes se ejecutan en contenedores Docker, en un solo servidor. Un único punto de entrada recibe el tráfico; nada más se expone directamente.
Componentes
| Componente | Papel | Tecnología |
|---|---|---|
| Consola web | La interfaz usada en el navegador, en francés, inglés, árabe y español | Angular |
| Servicios de aplicación (API) | Toda la lógica de negocio: stock, ventas, compras, caja, finanzas, informes, documentos financieros, NadiPilot, integraciones | Java, Spring Boot |
| Autenticación | Cuentas, inicio de sesión, contraseñas, roles; página de inicio de sesión con la imagen de Nadigit IMS | Keycloak (OpenID Connect) |
| Datos de gestión | Artículos, stock, pedidos, pagos, clientes, proveedores, parámetros | PostgreSQL |
| Identidades | Usuarios y roles, separados de los datos de gestión | PostgreSQL |
| Punto de entrada HTTPS | Recibe todo el tráfico, lo cifra y dirige cada petición al componente adecuado | Nginx, certificados Let's Encrypt o propios |
| Documentos y licencia | Facturas y documentos generados, archivos subidos, licencia activa | Almacenamiento persistente del servidor |
Cómo circula una petición
- El usuario abre la consola web: el navegador la carga desde el punto de entrada HTTPS.
- Al iniciar sesión, la consola redirige al servicio de autenticación, que verifica el usuario y la contraseña y emite un token de acceso de corta duración.
- Cada llamada de la consola a los servicios de aplicación lleva ese token. Los servicios verifican su firma y después los roles del usuario y la organización activa antes de responder.
- Los servicios leen y escriben los datos de gestión. Los documentos generados (facturas, recibos, informes) se guardan en el almacenamiento persistente.
Servicios externos
Ninguno es obligatorio. Cada uno se activa en los parámetros y solo recibe lo necesario para su función.
| Servicio | Cuándo se usa |
|---|---|
| Servidor de licencias de Nadigit | Activación con clave de registro y verificación en línea. Una licencia en archivo funciona sin él. |
| Proveedor de IA | NadiPilot y la extracción de facturas, si la IA está activada; un modelo local (Ollama) mantiene los datos en su red. Vea Configuración. |
| Búsqueda web | Tendencias de mercado de NadiPilot (Enterprise). |
| Correo, Telegram, WhatsApp | Notificaciones y alertas. |
| Tiendas en línea | Integración e-commerce (Enterprise). Vea Integración e-commerce. |
Datos y organizaciones
- Una instalación, una base de datos de gestión. Los datos permanecen en el servidor donde está instalado Nadigit IMS.
- Organizaciones (Enterprise). Una instalación puede gestionar varias empresas. Cada organización tiene sus propios almacenes, tiendas, catálogo, clientes, proveedores, stock, ventas, compras y finanzas; los usuarios son comunes a la instalación y acceden a las organizaciones de las que son miembros. Vea Seguridad y protección de datos.
- Evolución del esquema. En cada actualización, la base se migra automáticamente al arrancar; una migración que falla detiene el arranque en lugar de dejar funcionar la aplicación sobre una base incoherente.
Multilingüe
La interfaz está disponible en francés, inglés, árabe y español, con escritura de derecha a izquierda para el árabe. El idioma de los documentos generados (facturas, recibos, correos) se configura por separado, para la organización.
Escalabilidad
La misma arquitectura sirve desde el comercio con un solo punto de venta hasta la empresa que gestiona varias sociedades, almacenes y tiendas. Lo que cambia de un plan a otro son las funciones y los límites (usuarios, almacenes, tiendas), no la instalación. Vea Licencias y planes.