data visualizer app

Приложение для визуализатора данных и плагин

Это репо, в котором содержатся данные Visualizer-APP и его плагин, используемый как внутри, так и созданный в качестве отдельной точки входа, чтобы его можно было использовать в других приложениях, таких как приложение Dashboard

Начиная

Чтобы запустить Data-Visualizer-App из каталога Repo Root, установите зависимости:

 $ yarn install

Разработка

Запустите yarn start с корня репо, чтобы запустить приложение на localhost:3000 и плагин на localhost:3001 .

Запуск плагина на другом порте позволяет тестировать его в других приложениях. Например, для тестирования его в приложении Dashboard запустите приложение для приборной панели в другом порте и через Devtools переопределяют путь плагина с хостом и портом, где работает плагин. Пример шагов:

1. В DV: yarn start
2. В приборной панели: yarn start в этой точке DV работает на Localhost: 3000, DV Plugin On Localhost: 3001 и приложение для приборной панели на Localhost: 3002.
3. Укажите браузер на Localhost: 3002.
4. Добавьте эту запись в приложение Dashboard LocalStorage через DevTools в вкладке приложения: dhis2.dashboard.pluginOverrides: { "VISUALIZATION": "http://localhost:3001/plugin.html" }

С тем же принципом можно проверить несколько плагинов одновременно, вам просто нужно убедиться, что порт, настроенный в переопределении, является правильным для плагина, который вы переоцениваете.

Следующие сценарии NPM можно запускать из каталога репо Root:

Модульные тесты

 $ yarn test

Запустите модульные тесты с отчетом о покрытии

 $ yarn coverage

E2E тесты

Кипарис используется для тестов браузера E2E. Это автоматически работает на CI для PRS, результат можно увидеть в Cypress Cloud.

Чтобы записать тесты в Cypress Cloud, вы можете использовать один из следующих методов на основе ваших потребностей:

• Сообщение о коммите : Включите [e2e record] в сообщения о своих коммитировках для активации записи.
• Метки Github : примените метку e2e record к вашему запросу на вытяжение, чтобы запустить запись.

Эта настройка помогает более эффективно управлять облачными кредитами Cypress, обеспечивая, чтобы записи были сделаны только в случае явного требования.

Чтобы запустить тесты локально, определите следующее в локальном файле cypress.env.json , например:

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

Запустите тесты интерактивно (Cypress UI):

 yarn cypress:live

Запустите тесты в консоли без Cypress UI:

 yarn cypress:run

Линовая и форматирование

Автоматически исправить все нарушения в стиле кода (краситель и эслинт)

 $ yarn format

Проверьте все файлы на предмет нарушений в стиле кода (краситель и Eslint)

 $ yarn lint

Создать приложение и плагин

 $ yarn build

Ручное тестирование с NetLify

Этот репомитирован настроен для развертывания запросов на притяжение для NetLify. Это позволяет простать обмене реализации с другими (например, тестером, менеджером по продукту, UX, коллегам -разработчикам) перед слиянием в Master.

Запросы на вытягивание (т.е. #209) доступны по адресу:

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

NetLify также добавит проверку состояния в каждый PR, который ссылается непосредственно с развертыванием PR.