From cbcbaceb16a29066548ce230db0db90957441f28 Mon Sep 17 00:00:00 2001 From: acaptutorials Date: Thu, 26 Dec 2024 17:25:19 +0800 Subject: [PATCH 1/5] docs: add end date for acap 2.0 in the changelog --- docs/pages/changelog.mdx | 6 +++--- docs/theme.config.jsx | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/pages/changelog.mdx b/docs/pages/changelog.mdx index 5ec54bc6..6009c651 100644 --- a/docs/pages/changelog.mdx +++ b/docs/pages/changelog.mdx @@ -46,12 +46,12 @@ This page contains summary of features and enhancements on major ACAP versions a ### Version 2 (ACAP 2.0) -_June 2024 - ongoing_ +_June 2024 - December 2024_ -Version 2.0 highlights ongoing improvements and newly added features, expanding and enhancing the initial [ACAP](#version-1-acap-10) version. +Versions from 2.0+ highlight ongoing improvements and newly added features, expanding and enhancing the initial [ACAP](#version-1-acap-10) version. -ACAP 2.0 is the latest ACAP version. It's latest stable version is Release/Tag version {process.env.RELEASE_VERSION ?? '0.0.0'}, dev branch @{process.env.COMMIT_ID ?? '123456'} accessible in the **acap-v2** code repository. +ACAP 2.0 is the latest ACAP version. Its latest stable version is Release/Tag version {process.env.RELEASE_VERSION ?? '0.0.0'}, dev branch @{process.env.COMMIT_ID ?? '123456'} accessible in the **acap-v2** code repository. diff --git a/docs/theme.config.jsx b/docs/theme.config.jsx index 63b5e66e..a9b4b16b 100644 --- a/docs/theme.config.jsx +++ b/docs/theme.config.jsx @@ -34,7 +34,7 @@ export default { return ( <> - + From b7f1c38f9a8891b37c638e6318ff77489ab7d27b Mon Sep 17 00:00:00 2001 From: acaptutorials Date: Thu, 26 Dec 2024 17:26:47 +0800 Subject: [PATCH 2/5] docs: additional notes for deploying pre-acap 2.1 excel templates to live sites --- .../cropping-calendar/calendar-v2.mdx | 10 +++++++++- .../recommendations/recommendations-v2.mdx | 10 +++++++++- 2 files changed, 18 insertions(+), 2 deletions(-) diff --git a/docs/pages/post-installation/cropping-calendar/calendar-v2.mdx b/docs/pages/post-installation/cropping-calendar/calendar-v2.mdx index 738f3166..0eda13bf 100644 --- a/docs/pages/post-installation/cropping-calendar/calendar-v2.mdx +++ b/docs/pages/post-installation/cropping-calendar/calendar-v2.mdx @@ -15,7 +15,7 @@ Follow this [link](/post-installation/cropping-calendar/calendar-v1) to view cr ### Data Format -The latest updates for ACAP 2.1, starting with @commit **95a97cd** in the **acap-v2 dev** branch, use a new Cropping Calendar Excel template different from the ones mentioned on this page. +The latest updates for **ACAP 2.1**, starting with @commit **95a97cd** in the **acap-v2 dev** branch, use a new Cropping Calendar Excel template different from the ones mentioned on this page. > These Cropping Calendars are only compatible up to @commit **ee49568** in the **acap-v2 dev** branch. @@ -92,6 +92,14 @@ The **crop stage codes** should match those defined in the [ACAP 2.0 crop recomm Update the frontend and backend codes with necessary data for supporting other crops, with data formats described in the [Data Format](#data-format) and [Crop Stage Codes and Labels](#crop-stage-codes-and-labels) section. + +**Overwrite** and **commit** the sample cropping calendar Excel template files `corn_cropping_calendar.xlsx` and `corn_cropping_calendar.xlsx` in the **server** directory with the **regional cropping calendar files** to change the default sample Excel templates during live deployment. + +Also, change the values of the environment variables (`CROPPING_CALENDAR_RICE_EXCEL_FILE`, `CROPPING_CALENDAR_CORN_EXCEL_FILE`) associated with its file names in the **client** `.env` file and **GitHub Secrets** if there is a need to use different file names or add new templates. + +> **NOTE**: This step is only compatible until @commit **ee49568** (pre-ACAP 2.1) in the **acap-v2 dev** branch. Kindly chat the ACAP group chat for more information about the new Cropping Calendar Excel file format and management for ACAP 2.1 if it's missing in the online documentation. + + ### Login as Admin Login as an ACAP admin, then, navigate to the **Cropping Calendar Management** page in the `/admin/cropping-calendars` route. diff --git a/docs/pages/post-installation/recommendations/recommendations-v2.mdx b/docs/pages/post-installation/recommendations/recommendations-v2.mdx index 52532955..1bf2b582 100644 --- a/docs/pages/post-installation/recommendations/recommendations-v2.mdx +++ b/docs/pages/post-installation/recommendations/recommendations-v2.mdx @@ -13,7 +13,7 @@ Follow this [link](/post-installation/recommendations/recommendations-v1) to vi ## Data Format -The latest updates for ACAP 2.1, starting with @commit **95a97cd** in the **acap-v2 dev** branch, use a new Crop Recommendations Excel template different from the ones mentioned on this page. +The latest updates for **ACAP 2.1**, starting with @commit **95a97cd** in the **acap-v2 dev** branch, use a new Crop Recommendations Excel template different from the ones mentioned on this page. > These Crop Recommendations are only compatible up to @commit **ee49568** in the **acap-v2 dev** branch. @@ -62,6 +62,14 @@ The **crop stage labels** should match the **crop stage codes** defined in the [ Update the frontend and backend codes with necessary data for supporting other crops, with data formats described in the [Data Format](#data-format) section. + +**Overwrite** and **commit** the sample cropping calendar Excel template files `rice_recommendations_v4.xlsx` and `corn_recommendations_v3.xlsx` in the **server** directory with the **regional recommendation files** to change the default sample Excel templates during live deployment. + +Also, change the values of the environment variables (`RECOMMENDATIONS_RICE_EXCEL_FILE`, `RECOMMENDATIONS_CORN_EXCEL_FILE`) associated with its file names in the **client** `.env` file and **GitHub Secrets** if there is a need to use different file names or add new templates. + +> **NOTE:** This step is only compatible until @commit **ee49568** (pre-ACAP 2.1) in the **acap-v2 dev** branch. Kindly chat the ACAP group chat for more information about the new Crop Recommendations Excel file format and management for ACAP 2.1 if it's missing in the online documentation. + + ### Login as Admin Login as an ACAP admin, then, navigate to the **Recommendations Management** page in the `/admin/manage-recommendations` route. From dfacef363880a7a6232b87533f0af34b4c9a04f8 Mon Sep 17 00:00:00 2001 From: acaptutorials Date: Thu, 26 Dec 2024 17:41:46 +0800 Subject: [PATCH 3/5] docs: add url link to pre-acap 2.1 excel templates preparation --- docs/pages/installation/client-setup.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/pages/installation/client-setup.mdx b/docs/pages/installation/client-setup.mdx index fcb1cafd..13325d70 100644 --- a/docs/pages/installation/client-setup.mdx +++ b/docs/pages/installation/client-setup.mdx @@ -71,6 +71,10 @@ RECOMMENDATIONS_CORN_EXCEL_FILE 3. Copy the the **/server/src/scripts/data/pagasa_seasonal_v2.xlsx** Excel file to the **"files"** directory 4. Use the **"files"** directory and its contents on localhost development but not push it to the repository. + + Follow the steps under the [Cropping Calendar](/post-installation/cropping-calendar/calendar-v2/#prepare-the-frontend--backend) and [Crop Recommendations](/post-installation/recommendations/recommendations-v2/#prepare-the-frontend--backend) Post-Installation steps to change the Excel templates uploaded during live deployment. + + ### Update environment variables after deployment Certain client environment variables, such as URLs (i.e., `BASE_URL_PROD`) will become available after deployment. Update the rest of the `.env` variables later after: From 72d1641bff5e305b11a99f15245c1cf62cafcd39 Mon Sep 17 00:00:00 2001 From: acaptutorials Date: Thu, 26 Dec 2024 17:44:52 +0800 Subject: [PATCH 4/5] docs: default municipality additional info --- docs/pages/installation/client-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/pages/installation/client-setup.mdx b/docs/pages/installation/client-setup.mdx index 13325d70..20fc0774 100644 --- a/docs/pages/installation/client-setup.mdx +++ b/docs/pages/installation/client-setup.mdx @@ -21,7 +21,7 @@ The **client** `REGION_NAME` should be similar with the **server** `REGION_NAME` ```env copy REGION_NAME DEFAULT_PROVINCE -DEFAULT_MUNICIPALITY // --> Any municipality under the DEFAULT_PROVINCE +DEFAULT_MUNICIPALITY // --> Any municipality under the DEFAULT_PROVINCE also among the AMIA Villages NEXT_PUBLIC_FIREBASE_WEB_API_KEY NEXT_PUBLIC_FIREBASE_WEB_AUTHDOMAIN NEXT_PUBLIC_FIREBASE_WEB_PROJECT_ID From 49cfb9213f501fa98e49f40a5fdb45eee38758c4 Mon Sep 17 00:00:00 2001 From: acaptutorials Date: Thu, 26 Dec 2024 17:59:38 +0800 Subject: [PATCH 5/5] docs: add temporary url link for more info about acap 2.1 updates --- docs/pages/changelog.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/pages/changelog.mdx b/docs/pages/changelog.mdx index 6009c651..972ee25e 100644 --- a/docs/pages/changelog.mdx +++ b/docs/pages/changelog.mdx @@ -75,7 +75,7 @@ Version 2.0 and later versions may have new requirements that will thrive on new 1. Integration of climate risk trigger in public/admin crop recommendations and bulletin PDF generation 2. Support for multiple crops (cropping calendar and crop recommendations) - - Support new multiple recommendations/cropping calendar Excel files with new formats and structure + - Support new multiple recommendations/cropping calendar Excel files with new formats and structure. 3. Admin Pages - Cropping Calendar Excel file uploader - Crop Recommendations Excel file uploader @@ -90,7 +90,7 @@ Version 2.0 and later versions may have new requirements that will thrive on new 7. REST APIs (NodeJS) - New endpoints for processing cropping calendar and recommendations Excel file uploads - Migration of the [ACAP-RCMAS REST APIs](/post-installation/acap-rcmas-api) from the (forked) mirror environment with optional activation and deployment -8. _(More **"ACAP 2.1"** feature update details to follow, starting from the `dev` branch @commit **95a97cd**)_ +8. _(More **"ACAP 2.1"** feature update details to follow, starting from the `dev` branch @commit **95a97cd**. In the meantime, see the [link](https://github.com/amia-cis/acap-v2/releases/tag/v10.1.0-alpha.10) for more information.)_ #### Changed