data visualizer app

Aplicación de visualizador de datos y complemento

Este es un repositorio que contiene la aplicación de visualización de datos y su complemento utilizado tanto internamente como construido como un punto de entrada separado para que pueda usarse en otras aplicaciones, como la aplicación del tablero.

Empezando

Para ejecutar Data-visualizer-app desde el directorio de Repo Root, instale las dependencias:

 $ yarn install

Desarrollo

Ejecute yarn start desde la raíz del repositorio para iniciar la aplicación en localhost:3000 y el complemento en localhost:3001 .

Ejecutar el complemento en un puerto diferente permite probarlo en otras aplicaciones. Por ejemplo, para probarlo en la aplicación del tablero, ejecute la aplicación del tablero en un puerto diferente y a través de DevTools anule la ruta del complemento con el host y el puerto donde se ejecuta el complemento. Pasos de ejemplo:

1. En dv: yarn start
2. En el tablero: yarn start en este punto DV se ejecuta en Localhost: 3000, complemento DV en Localhost: 3001 y la aplicación de tablero en Localhost: 3002.
3. Apunte el navegador al localhost: 3002.
4. Agregue esta entrada a la aplicación del tablero de almacenamiento local a través de DevTools en la pestaña de la aplicación: dhis2.dashboard.pluginOverrides: { "VISUALIZATION": "http://localhost:3001/plugin.html" }

Con el mismo principio es posible probar varios complementos al mismo tiempo, solo necesita asegurarse de que el puerto configurado en la anulación sea el correcto para el complemento que está anulando.

Los siguientes scripts NPM se pueden ejecutar desde el directorio de Repo Root:

Pruebas unitarias

 $ yarn test

Ejecutar pruebas unitarias con informe de cobertura

 $ yarn coverage

pruebas de E2E

Cypress se usa para pruebas de navegador E2E. Esto se ejecuta automáticamente en CI para PRS, el resultado se puede ver en la nube de Cypress.

Para grabar pruebas en Cypress Cloud, puede usar uno de los siguientes métodos basados ​​en sus necesidades:

• Mensaje de confirmación : incluya [e2e record] en sus mensajes de confirmación para activar la grabación.
• Etiquetas de GitHub : aplique el sello e2e record a su solicitud de extracción para activar la grabación.

Esta configuración ayuda a administrar los créditos de Cypress Cloud de manera más eficiente, asegurando que las grabaciones solo se realicen cuando se requieren explícitamente.

Para ejecutar las pruebas localmente, defina lo siguiente en un archivo local cypress.env.json , por ejemplo:

{
    " dhis2BaseUrl " : " https://test.e2e.dhis2.org/dev " ,
    " dhis2Username " : " admin " ,
    " dhis2Password " : " district " ,
}

Ejecutar pruebas interactivamente (ui de cipreses):

 yarn cypress:live

Ejecutar pruebas en la consola sin UI de Cypress:

 yarn cypress:run

Pelusas y formateo

Arregle automáticamente todas las violaciones de estilo de código fijo (más bonitas y eSlint)

 $ yarn format

Consulte todos los archivos para ver las violaciones de estilo de código (más bonitas y eSlint)

 $ yarn lint

Crear aplicación y complemento

 $ yarn build

Prueba manual con NetLify

Este repositorio está configurado para implementar solicitudes de extracción para netlify. Esto simplifica compartir una implementación en ejecución con otros (por ejemplo, probador, gerente de productos, UX, compañeros desarrolladores) antes de fusionarse para dominar.

Las solicitudes de extracción (es decir, #209) están disponibles en:

https://pr-209--dhis2-data-visualizer.netlify.app

NetLify también agregará una verificación de estado a cada PR que se vincula directamente a la implementación de PR.