feat: modular integration with ENACTS API

.gitignore

@@ -5,3 +5,4 @@ src/locales
 build
 .DS_Store
 .vscode
+cypress.env.json

README.md

@@ -1,32 +1,83 @@
-## DHIS2 Climate app
+# DHIS2 Climate App
 
-This app allows you to explore and import temperature and precipitation data in DHIS2. The data source is "ERA5-Land", which is considered the most accurate and complete global climate dataset available.
+---
+
+## General Documentation
+
+### Overview
+
+This app allows you to explore and import climate/weather data into DHIS2.
+
+### Data Sources
+
+-   **ERA5-Land**: By default, the app uses ERA5-Land, a highly accurate and complete global climate dataset.
+-   **ENACTS**: If ENACTS is configured (see Admin Documentation), the app can also use ENACTS DST as a data source for local climate data.
+
+> ![Screenshot](public/images/explore.png)
+
+---
 
-![Screenshot](public/images/explore.png)
+## Admin Documentation
+
+### ENACTS Setup Instructions
+
+The ENACTS API is made available to this app using a DHIS2 route. To set up ENACTS integration, follow these steps:
+
+1. **Follow the [DHIS2 Routes documentation](https://docs.dhis2.org/en/develop/using-the-api/dhis-core-version-master/route.html)** to set up the route. Make sure to use the documentation specific to your DHIS2 version, as there are some differences between versions.
+
+2. **Route configuration fields:**
+
+    - The following fields must be set in the route configuration. Note that the `code` must be `enacts`.
+    - **name**: Choose a name that indicates this route is to ENACTS DST
+    - **code**: `enacts`
+    - **url**: The URL where your ENACTS DST is hosted. You must append `/**` to the URL.
+    - **headers**:
+        - `Content-Type`: `application/json`
+        - `X-API-Key`: _Your ENACTS API key here_
+    - **disabled**: `false`
+
+3. **Example configuration:**
+
+```json
+{
+    "name": "ENACTS API",
+    "code": "enacts",
+    "url": "https://your-enacts-dst-url/**",
+    "headers": {
+        "Content-Type": "application/json",
+        "X-API-Key": "Your enacts api key here"
+    },
+    "disabled": false
+}
+```
+
+After configuring the route, the ENACTS API will be available for use in the Climate app.
 
 ---
 
+## Developer Documentation
+
 This project was bootstrapped with [DHIS2 Application Platform](https://github.com/dhis2/app-platform).
 
-## Available Scripts
+### Available Scripts
 
 In the project directory, you can run:
 
-### `yarn start`
+#### `yarn start`
 
 Runs the app in the development mode.<br />
 Open [http://localhost:3000](http://localhost:3000) to view it in the browser.
 
 The page will reload if you make edits.<br />
 You will also see any lint errors in the console.
 
-### `yarn test`
+#### `yarn test`
 
 Launches the test runner and runs all available tests found in `/src`.<br />
 
 See the section about [running tests](https://platform.dhis2.nu/#/scripts/test) for more information.
 
-### `yarn build`
+#### `yarn build`
 
 Builds the app for production to the `build` folder.<br />
 It correctly bundles React in production mode and optimizes the build for the best performance.
@@ -36,7 +87,7 @@ A deployable `.zip` file can be found in `build/bundle`!
 
 See the section about [building](https://platform.dhis2.nu/#/scripts/build) for more information.
 
-### `yarn deploy`
+#### `yarn deploy`
 
 Deploys the built app in the `build` folder to a running DHIS2 instance.<br />
 This command will prompt you to enter a server URL as well as the username and password of a DHIS2 user with the App Management authority.<br/>

i18n/en.pot

@@ -5,8 +5,8 @@ msgstr ""
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Plural-Forms: nplurals=2; plural=(n != 1)\n"
-"POT-Creation-Date: 2025-09-08T09:55:48.384Z\n"
-"PO-Revision-Date: 2025-09-08T09:55:48.384Z\n"
+"POT-Creation-Date: 2025-12-11T11:59:19.879Z\n"
+"PO-Revision-Date: 2025-12-11T11:59:19.880Z\n"
 
 msgid "About this app"
 msgstr "About this app"
@@ -644,6 +644,9 @@ msgstr ""
 msgid "Extracting data for {{orgUnitsCount}} org units"
 msgstr "Extracting data for {{orgUnitsCount}} org units"
 
+msgid "Dataset provider not recognized"
+msgstr "Dataset provider not recognized"
+
 msgid "Importing data to DHIS2"
 msgstr "Importing data to DHIS2"
 
@@ -656,16 +659,19 @@ msgstr "One or more conflicts encountered"
 msgid "Import weather and climate data"
 msgstr "Import weather and climate data"
 
+msgid "Data"
+msgstr "Data"
+
 msgid ""
 "You can maximum import {{maxValues}} data values in a single import, but "
 "you are trying to import {{valueCount}} values for {{orgUnitCount}} "
-"organisation units over {{periodCount}} {{periodType}} periods. Please "
+"organisation units over {{periodCount}} {{periodTypeName}} periods. Please "
 "select a shorter period or fewer organisation units. You can always import "
 "more data later."
 msgstr ""
 "You can maximum import {{maxValues}} data values in a single import, but "
 "you are trying to import {{valueCount}} values for {{orgUnitCount}} "
-"organisation units over {{periodCount}} {{periodType}} periods. Please "
+"organisation units over {{periodCount}} {{periodTypeName}} periods. Please "
 "select a shorter period or fewer organisation units. You can always import "
 "more data later."
 
@@ -686,9 +692,6 @@ msgstr ""
 "Data can be imported in batches. We recommend that you start with a few "
 "organisation units to make sure everything works as expected."
 
-msgid "Data"
-msgstr "Data"
-
 msgid "Select the variable you would like to import."
 msgstr "Select the variable you would like to import."
 
@@ -754,14 +757,17 @@ msgstr ""
 msgid "Data is imported"
 msgstr "Data is imported"
 
-msgid "Imported"
-msgstr "Imported"
+msgid "Imported: {{imported}}"
+msgstr "Imported: {{imported}}"
+
+msgid "Updated: {{updated}}"
+msgstr "Updated: {{updated}}"
 
-msgid "Updated"
-msgstr "Updated"
+msgid "Ignored: {{ignored}}"
+msgstr "Ignored: {{ignored}}"
 
-msgid "Ignored"
-msgstr "Ignored"
+msgid "Missing: {{missing}}"
+msgstr "Missing: {{missing}}"
 
 msgid "No data for the following org units"
 msgstr "No data for the following org units"
@@ -779,6 +785,15 @@ msgstr "Organisation unit level to import data to"
 msgid "Org unit parent needs to be above or equal to the org unit level"
 msgstr "Org unit parent needs to be above or equal to the org unit level"
 
+msgid "Start and end date are not within the valid range."
+msgstr "Start and end date are not within the valid range."
+
+msgid "Start date is not within the valid range."
+msgstr "Start date is not within the valid range."
+
+msgid "End date is not within the valid range."
+msgstr "End date is not within the valid range."
+
 msgid ""
 "The data will be assigned a default yearly period that matches the year it "
 "was collected: {{datasetPeriod}}"
@@ -789,6 +804,9 @@ msgstr ""
 msgid "Daily values will be imported between start and end dates"
 msgstr "Daily values will be imported between start and end dates"
 
+msgid "Valid range"
+msgstr "Valid range"
+
 msgid "Period type"
 msgstr "Period type"
 
@@ -831,6 +849,28 @@ msgstr "Heat stress upper category"
 msgid "Heat stress lower category"
 msgstr "Heat stress lower category"
 
+msgid "Data Providers"
+msgstr "Data Providers"
+
+msgid ""
+"The following data providers can be configured and used in the Climate app. "
+"Contact your administrator to add or update data providers."
+msgstr ""
+"The following data providers can be configured and used in the Climate app. "
+"Contact your administrator to add or update data providers."
+
+msgid "Provider name"
+msgstr "Provider name"
+
+msgid "Status"
+msgstr "Status"
+
+msgid "Setup info"
+msgstr "Setup info"
+
+msgid "Close"
+msgstr "Close"
+
 msgid "Calculate from data"
 msgstr "Calculate from data"
 
@@ -840,6 +880,9 @@ msgstr "App settings"
 msgid "Changes made below will apply to all users of this app."
 msgstr "Changes made below will apply to all users of this app."
 
+msgid "General settings"
+msgstr "General settings"
+
 msgid "Default start page for users"
 msgstr "Default start page for users"
 
@@ -873,6 +916,9 @@ msgstr "Aggregate"
 msgid "Aggregation type"
 msgstr "Aggregation type"
 
+msgid "Use your domain knowledge to select the appropriate aggregation type"
+msgstr "Use your domain knowledge to select the appropriate aggregation type"
+
 msgid "Store zero data values"
 msgstr "Store zero data values"
 
@@ -1009,9 +1055,21 @@ msgstr ""
 msgid "Loading data"
 msgstr "Loading data"
 
+msgid "Error"
+msgstr "Error"
+
 msgid "Select data to import"
 msgstr "Select data to import"
 
+msgid "Data is from {{source}}. Accessed via {{provider}}."
+msgstr "Data is from {{source}}. Accessed via {{provider}}."
+
+msgid "Warning"
+msgstr "Warning"
+
+msgid "Error fetching additional datasets from one or more local data providers"
+msgstr "Error fetching additional datasets from one or more local data providers"
+
 msgid "You need access to Google Earth Engine to use this app."
 msgstr "You need access to Google Earth Engine to use this app."
 
@@ -1106,21 +1164,6 @@ msgstr ""
 msgid "Land cover types at yearly intervals"
 msgstr "Land cover types at yearly intervals"
 
-msgid "Climate/Weather"
-msgstr "Climate/Weather"
-
-msgid "Environment"
-msgstr "Environment"
-
-msgid "Weekly or Monthly"
-msgstr "Weekly or Monthly"
-
-msgid "Land"
-msgstr "Land"
-
-msgid "Yearly"
-msgstr "Yearly"
-
 msgid "Air temperature (ERA5-Land)"
 msgstr "Air temperature (ERA5-Land)"
 
@@ -1194,6 +1237,15 @@ msgstr ""
 "that can exist in the air at its current temperature. Calculated using air "
 "temperature and dewpoint temperature at 2 m above surface."
 
+msgid "Local Min Tempreture (Land)"
+msgstr "Local Min Tempreture (Land)"
+
+msgid "Local Max Tempreture (Land)"
+msgstr "Local Max Tempreture (Land)"
+
+msgid "Local Precipitation "
+msgstr "Local Precipitation "
+
 msgid "Heat stress (ERA5-HEAT)"
 msgstr "Heat stress (ERA5-HEAT)"
 
@@ -1266,6 +1318,21 @@ msgstr "Standard deviation of elevation in meters above sea level."
 msgid "Percentage of area with this land cover type."
 msgstr "Percentage of area with this land cover type."
 
+msgid "Climate/Weather"
+msgstr "Climate/Weather"
+
+msgid "Environment"
+msgstr "Environment"
+
+msgid "Weekly or Monthly"
+msgstr "Weekly or Monthly"
+
+msgid "Land"
+msgstr "Land"
+
+msgid "Yearly"
+msgstr "Yearly"
+
 msgid "Heat/cold stress"
 msgstr "Heat/cold stress"
 

package.json

@@ -13,21 +13,18 @@
         "format": "d2-style apply"
     },
     "devDependencies": {
-        "@dhis2/cli-app-scripts": "^12.0.0",
-        "@dhis2/cli-style": "^10.7.7"
+        "@dhis2/cli-app-scripts": "^12.8.0",
+        "@dhis2/cli-style": "^10.7.9"
     },
     "dependencies": {
-        "@dhis2/app-runtime": "^3.12.1",
-        "@dhis2/multi-calendar-dates": "1.0.0-alpha.27",
-        "@dhis2/ui": "^10.1.10",
+        "@dhis2/app-runtime": "^3.14.6",
+        "@dhis2/multi-calendar-dates": "^2.1.2",
+        "@dhis2/ui": "^10.9",
         "@turf/area": "^6.5.0",
+        "classnames": "^2.5.1",
         "highcharts": "^10.3.3",
         "react-router-dom": "^6.26.1",
         "zustand": "^4.5.5"
     },
-    "resolutions": {
-        "@dhis2/cli-app-scripts/**/@dhis2/multi-calendar-dates": "1.2.3",
-        "@dhis2/multi-calendar-dates": "1.0.0-alpha.27"
-    },
     "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
 }

src/components/explore/climateChange/ClimateChange.jsx

@@ -3,7 +3,7 @@ import { useMemo } from 'react'
 import {
     era5MonthlyTemperatures,
     era5MonthlyNormals,
-} from '../../../data/datasets.js'
+} from '../../../data/earth-engine-datasets.js'
 import useAppSettings from '../../../hooks/useAppSettings.js'
 import useEarthEngineClimateNormals from '../../../hooks/useEarthEngineClimateNormals.js'
 import useEarthEngineTimeSeries from '../../../hooks/useEarthEngineTimeSeries.js'

src/components/explore/elevation/Elevation.jsx

@@ -1,5 +1,5 @@
 import i18n from '@dhis2/d2-i18n'
-import { demResolution } from '../../../data/datasets.js'
+import { demResolution } from '../../../data/earth-engine-datasets.js'
 import useEarthEngineTimeSeries from '../../../hooks/useEarthEngineTimeSeries.js'
 import exploreStore from '../../../store/exploreStore.js'
 import DataLoader from '../../shared/DataLoader.jsx'

src/components/explore/heat/HeatDaily.jsx

@@ -1,4 +1,4 @@
-import { era5HeatDaily } from '../../../data/datasets.js'
+import { era5HeatDaily } from '../../../data/earth-engine-datasets.js'
 import useAppSettings from '../../../hooks/useAppSettings.js'
 import useEarthEngineTimeSeries from '../../../hooks/useEarthEngineTimeSeries.js'
 import exploreStore from '../../../store/exploreStore.js'

src/components/explore/heat/HeatMonthly.jsx

@@ -1,4 +1,4 @@
-import { era5HeatMonthly } from '../../../data/datasets.js'
+import { era5HeatMonthly } from '../../../data/earth-engine-datasets.js'
 import useAppSettings from '../../../hooks/useAppSettings.js'
 import useEarthEngineTimeSeries from '../../../hooks/useEarthEngineTimeSeries.js'
 import exploreStore from '../../../store/exploreStore.js'