Studio de código abierto
Dashboard Studio ofrece una opción de código abierto (licencia MPL-2.0) para equipos técnicos que necesitan una personalización del frontend más allá de la configuración estándar. Modifique la interfaz de usuario, integre con aplicaciones existentes o implemente sistemas de diseño personalizados mientras mantiene todas las capacidades de análisis.
Casos de uso
Escenarios comunes en los que el enfoque de código abierto puede ser útil:
Branding personalizado e integración del sistema de diseño
Flujos de trabajo de IU especializados por industria
Analítica embebida en aplicaciones propietarias
Implementaciones de marca blanca para socios
Requisitos previos
Acceso a IoT Query
Instancia activa con credenciales de base de datos válidas
Autenticación
Token JWT desde el Gateway de Autenticación de Navixy
Entorno de desarrollo
Node.js 18+, npm, Git
Habilidades técnicas
React, TypeScript, PostgreSQL, desarrollo web moderno
Vea App Connect en nuestra documentación para desarrolladores para detalles de implementación de autenticación.
Componentes de código abierto
La implementación de código abierto de Dashboard Studio consta de tres componentes principales:
Repositorio de GitHub
Ubicación: https://github.com/SquareGPS/navixy-iot-query-dashboard
El repositorio contiene la aplicación frontend completa en React, servicios backend en Node.js, archivos de configuración y documentación exhaustiva. Clone el repositorio para desarrollo local o para revisar la arquitectura antes de la implementación.
Paquete npm
Distribución optimizada para la integración en proyectos JavaScript. El paquete refleja la base de código de GitHub con el flujo de instalación estándar de npm. Consulte el repositorio README para instrucciones de instalación y control de versiones.
Gateway de autenticación
Generación de token JWT a través del gateway de autenticación de Navixy. El backend gestiona la administración de sesión de forma transparente. Vea App Connect en nuestra documentación para desarrolladores para detalles de implementación.
Comenzando
Pasos de configuración:
Revise el repositorio README
Asegúrese de que tiene acceso activo a IoT Query
Instale Node.js 18+ y npm
Siga la Guía de inicio rápido del repositorio para el despliegue local
Revise la documentación de arquitectura antes de personalizar
Documentación dentro del repositorio
El repositorio incluye guías completas para trabajar con la base de código:
Diseño del sistema, estructura de componentes, flujo de datos
Configuración local, normas de codificación, pruebas, flujos de trabajo
Endpoints del backend, formatos de petición/respuesta, autenticación
Alojamiento en producción para diversos entornos
Todos los archivos de documentación se encuentran en la carpeta /docs del repositorio. La base de código utiliza TypeScript en todo para seguridad de tipos e interfaces de componentes claras.
Opciones de personalización
La implementación de código abierto proporciona acceso completo al frontend para modificaciones:
IU y diseño
Biblioteca de componentes (colores, tipografía, espaciado, patrones de IU)
Integración de sistemas de diseño personalizados
Modificaciones de tema
Editor de paneles
Algoritmos de diseño personalizados
Métodos alternativos de disposición de paneles
Flujos de trabajo simplificados para grupos de usuarios específicos
Visualizaciones
Reemplazar componentes de gráficos existentes por otros personalizados
Agregar nuevos tipos de visualización
Modificar el comportamiento de renderizado de gráficos
Integración
Implementación de inicio de sesión único
Navegación compartida con aplicaciones existentes
Vistas analíticas embebidas
Revise la ARCHITECTURE.md archivo en el repositorio antes de modificaciones significativas para comprender las relaciones entre componentes y los cambios requeridos.
Paridad de funciones con la versión estándar
Dashboard Studio de código abierto mantiene paridad completa de funciones con la versión alojada por Navixy:
Editor de paneles (arrastrar y soltar, paneles, filas)
✓
✓
Ejecución de SQL (seguridad, tiempos de espera, caché)
✓
✓
Visualizaciones (barra, pastel, tabla, estadística)
✓
✓
Organización del menú (secciones, reordenamiento)
✓
✓
Actualizaciones y nuevas funciones
✓
✓
El repositorio recibe actualizaciones regulares alineadas con las versiones de la versión alojada. Nuevos tipos de visualización, capacidades del editor y mejoras de rendimiento aparecen en ambos modelos de despliegue simultáneamente.
Modelo de soporte y mantenimiento
Actualizaciones del núcleo de Dashboard Studio
✓
Parche de seguridad
✓
Compatibilidad con la API de IoT Query
✓
Actualizaciones de documentación
✓
Mantenimiento de código personalizado
✓
Infraestructura de despliegue
✓
Sincronización con el repositorio upstream
✓
Pruebas después de las actualizaciones
✓
Supervise el repositorio para lanzamientos que contengan correcciones de errores, parches de seguridad y funciones. Pruebe sus personalizaciones después de las actualizaciones antes de desplegarlas en producción.
Soporte y asistencia
Para soporte técnico y asistencia con IoT Query, contacte a nuestro equipo de soporte en [email protected].
Última actualización
¿Te fue útil?