data visualizer app

Aplikasi dan plugin Visualisasi Data

Ini adalah repo yang berisi data-visualizer-app dan pluginnya digunakan baik secara internal dan dibangun sebagai titik masuk terpisah sehingga dapat digunakan di aplikasi lain seperti aplikasi dasbor

Memulai

Untuk menjalankan data-visualizer-app dari direktori root repo, instal dependensi:

 $ yarn install

Perkembangan

Jalankan yarn start dari root repo untuk memulai aplikasi di localhost:3000 dan plugin di localhost:3001 .

Menjalankan plugin pada port yang berbeda memungkinkan untuk mengujinya di aplikasi lain. Misalnya, untuk mengujinya di aplikasi dasbor, jalankan aplikasi dasbor di port yang berbeda dan melalui DevTools mengganti jalur plugin dengan host dan port tempat plugin berjalan. Contoh Langkah:

1. Dalam DV: yarn start
2. Di Dashboard: yarn start pada titik ini DV berjalan di Localhost: 3000, DV Plugin di LocalHost: 3001 dan Aplikasi Dasbor di LocalHost: 3002.
3. Arahkan browser ke localhost: 3002.
4. Tambahkan entri ini ke aplikasi dashboard localstorage melalui devtools di tab aplikasi: dhis2.dashboard.pluginOverrides: { "VISUALIZATION": "http://localhost:3001/plugin.html" }

Dengan prinsip yang sama dimungkinkan untuk menguji beberapa plugin pada saat yang sama, Anda hanya perlu memastikan port yang dikonfigurasi di override adalah yang tepat untuk plugin yang Anda angkani.

Skrip NPM berikut semuanya dapat dijalankan dari direktori root repo:

Tes unit

 $ yarn test

Jalankan Tes Unit dengan Laporan Cakupan

 $ yarn coverage

tes e2e

Cypress digunakan untuk tes browser E2E. Ini secara otomatis berjalan pada CI untuk PRS, hasilnya dapat dilihat pada cloud Cypress.

Untuk merekam tes di Cypress Cloud, Anda dapat menggunakan salah satu metode berikut berdasarkan kebutuhan Anda:

• Pesan Komit : Sertakan [e2e record] dalam pesan komit Anda untuk mengaktifkan perekaman.
• Label GitHub : Terapkan label e2e record ke permintaan tarik Anda untuk memicu perekaman.

Pengaturan ini membantu dalam mengelola kredit cloud Cypress lebih efisien, memastikan rekaman hanya dibuat ketika secara eksplisit diperlukan.

Untuk menjalankan tes secara lokal, tentukan yang berikut dalam file cypress.env.json lokal, misalnya:

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

Jalankan tes secara interaktif (Cypress UI):

 yarn cypress:live

Jalankan tes di konsol tanpa cypress UI:

 yarn cypress:run

Berbaris dan format

Secara otomatis memperbaiki semua pelanggaran gaya kode yang dapat diperbaiki (lebih cantik dan eslint)

 $ yarn format

Periksa semua file untuk pelanggaran gaya kode (lebih cantik dan eslint)

 $ yarn lint

Bangun Aplikasi dan Plugin

 $ yarn build

Pengujian manual dengan netlify

Repo ini dikonfigurasi untuk menggunakan permintaan tarik ke Netlify. Ini membuatnya mudah untuk berbagi implementasi yang berjalan dengan orang lain (misalnya, penguji, manajer produk, UX, sesama pengembang) sebelum bergabung ke Master.

Permintaan tarik (yaitu #209) tersedia di:

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

Netlify juga akan menambahkan pemeriksaan status ke setiap PR yang menautkan langsung ke penyebaran PR.