Bienvenido a la sección de Ingeniería Napse

En esta guía encontrarás toda la documentación relacionada con la arquitectura, integración, flujos, servicios de comunicación y diseño de la Suite Napse, pensada para ofrecerte una visión completa de su estructura y funcionamiento.

INTRODUCCIÓN

Este documento describe en detalle la arquitectura general de integración de la suite Napse, proporcionando una base técnica y funcional que respalde la comprensión de su estructura, componentes y capacidades. Su objetivo principal es servir como guía para todos los equipos involucrados en la implementación, integración y operación de las soluciones de Napse, asegurando una alineación técnica y estratégica con las necesidades del negocio.

El alcance del documento incluye la descripción de las principales áreas de arquitectura técnica, tales como la integración con sistemas legados, la comunicación entre microservicios, protocolos de intercambio de datos, escalabilidad, resiliencia y observabilidad. Además, abarca aspectos técnicos específicos como los SLAs, la configuración de puntos de venta (POS), y el monitoreo de hardware y software.

El público objetivo de este documento incluye:

• Desarrolladores y equipos de TI: Para entender las especificaciones técnicas, las dependencias y las integraciones.
• Arquitectos de software: Para planificar y optimizar el diseño de la arquitectura.
• Gerentes de proyecto: Para coordinar las tareas y recursos relacionados con las implementaciones.
• Clientes y usuarios clave: Para comprender las capacidades del sistema y su alineación con los objetivos de negocio.
• Stakeholders de negocio: Para evaluar cómo la solución técnica respalda las necesidades comerciales.

Resumen de la Suite Napse

La suite Napse es una plataforma modular que ofrece soluciones integrales para la gestión de ventas, promociones, fidelización, flujos fiscales y omnicanalidad. Está diseñada bajo una arquitectura MACH (Microservicios, API-first, Cloud-native, Headless), lo que garantiza flexibilidad, escalabilidad y capacidad de integración con sistemas externos. Sus principales componentes incluyen:

• Bridge Central: Backoffice para la solución de ventas.
• Bridge API: Microservicios para integración.
• Bridge POS: Punto de Venta (Tienda, SelfOrder, SelfCheckOut, Mobile)
• PROMO: Solución para gestión de promociones y programas de fidelización.
• Omni: Microservicios omnicanal.
• Fiscal Flow: Gestión de comprobantes electrónicos.
• Prize: Gestor de comisiones.
• Director: Gestor y actualizador de versiones.

ARQUITECTURA GENERAL DE LA SUITE NAPSE

La suite Napse representa una solución integral diseñada para abordar las necesidades comerciales modernas en el ámbito de la gestión de ventas, promociones, fidelización, flujos fiscales y omnicanalidad. Su arquitectura está basada en principios de modularidad, escalabilidad y alta disponibilidad, y se implementa bajo una arquitectura MACH (Microservicios, API-first, Cloud-native y Headless). Este enfoque garantiza una integración eficiente con sistemas legados y externos, una adaptación flexible a las demandas del mercado y una experiencia de usuario consistente y optimizada.

La suite se divide en varios módulos especializados que trabajan de manera conjunta, permitiendo a las organizaciones gestionar de forma centralizada y descentralizada sus operaciones en la nube y en entornos locales (on-premise). Esto incluye funcionalidades que abarcan desde la configuración de puntos de venta hasta la sincronización en tiempo real de datos de transacciones, promociones, y movimientos de stock.

OBSERVABILIDAD Y MONITOREO

El monitoreo continuo de dispositivos y periféricos es esencial para mantener la operatividad de los sistemas POS en cada tienda. La suite Napse emplea herramientas avanzadas como Zabbix y Grafana para registrar el estado de los equipos y detectar fallos de forma proactiva.

Metodología de Monitoreo

• Zabbix:
  Utilizado para monitorear la disponibilidad y el rendimiento de los servidores y terminales POS.

  • Envía alertas automáticas en caso de fallos o caídas de dispositivos.
  • Proporciona informes detallados sobre el estado de los equipos.

• Grafana:
  Proporciona visualizaciones en tiempo real del estado de la infraestructura y los periféricos, como impresoras, escáneres y cajones de efectivo.

Beneficios del Monitoreo Proactivo

• Reducción del tiempo de inactividad.
• Mejora en la experiencia del cliente al asegurar que los dispositivos críticos estén siempre operativos.

OBSERVABILIDAD DE SISTEMA POS CENTRALIZADO (LOGS Y/O PLATAFORMA)

La observabilidad es clave para garantizar la estabilidad y trazabilidad de las operaciones en la suite Napse. Cada microservicio genera logs que son centralizados y gestionados para facilitar la supervisión del sistema.

Detalles del Sistema de Logs

• Los logs se generan en formato de texto y se almacenan en un sistema centralizado para su análisis.
• Zabbix Loki:
  Se utiliza para gestionar y analizar los logs de los servidores y terminales POS en tiempo real.
  • Detecta anomalías y permite el diagnóstico rápido de problemas.

Importancia de la Observabilidad

• Proporciona información detallada sobre el estado de los sistemas.
• Permite resolver incidencias rápidamente, minimizando el impacto en las operaciones.