Change Log

ACAP Change Log

This page contains summary of features and enhancements on major ACAP versions and their programming-development timelines.

Version 2 (ACAP 2.0)

June 2024 - ongoing

Version 2.0 highlights ongoing improvements and newly added features, expanding and enhancing the initial ACAP version.

ℹ️

ACAP 2.0 is the latest ACAP version. It's latest stable version is Release/Tag version v10.1.0-alpha.10, dev branch @95a97cd accessible in the acap-v2 code repository.

⚠️

Version 2.0 and later versions may have new requirements that will thrive on new development approaches loosely tied to the recommended Security and Server guidelines of ACAP 1.0, requiring thorough testing and validation.

...

Added

  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
  3. Admin Pages
    • Cropping Calendar Excel file uploader
    • Crop Recommendations Excel file uploader
    • Manage Recommendations
      • View the uploaded recommendations list
      • View an uploaded recommendation
      • Edit an uploaded recommendation
    • Phonebook: tag a contact to a province/municipality
  4. Use of tropical cyclone wind signals as a trigger for generating special weather recommendations
  5. Allow the creation of "general" special weather recommendations
  6. Optional search engine optimization (SEO) settings with Google Search Console
  7. REST APIs (NodeJS)
    • New endpoints for processing cropping calendar and recommendations Excel file uploads
    • Migration of the ACAP-RCMAS REST APIs 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)

Changed

  1. Public/admin seasonal recommendations and bulletin PDF generation
    • Removal of the single-month selection trigger for determining the crop stage/s
    • Removal of the rainfall condition trigger
  2. Public/admin 10-day recommendations and bulletin PDF generation
    • Removal of the single-date selection trigger within the active PAGASA 10-day date range for determining the crop stage/s
  3. Deprecation of the uploaders group of Node Package Manager (NPM) scripts in favor of cropping calendar/recommendations Excel file upload through the UI
  4. Allow creating seasonal bulletin PDFs with more than one (1) page.
  5. Text blast recipients by province/municipality instead of individual selection

Fixed

Version 1 (ACAP 1.0)

ℹ️

ACAP 1.0's last stable version is Release/Tag version v9.5.6 (opens in a new tab), accessible in the climate-services-webportal-v1 and acap-v2 code repositories.

Version 1.0 marks the initial ACAP Bicol release used as a base model and template for subsequent developer training and sharing with other regions in the succeeding years starting on July 2023 (opens in a new tab).

Developed with a Security-first approach, ACAP 1.0 especially notes common Firestore security pitfalls and keeps a watchful eye on Cross-Site Scripting (XSS) attacks since it uses What-You-See-Is-What-You-Get (WYSIWYG) HTML input for crop recommendations and PDF generation.

It has the following features, strictly following and is tested compatible with the recommended Security and Server guidelines:

Added

March - December 2022

  1. Login and User Authentication
  2. User (Admin) Accounts Management
  3. PDF Bulletins Generator
  4. Site Search
  5. Public Pages
    • Home Page
    • ACAP Services Page (Weather Services)
      • 10-Day Weather Forecast Summary
      • Seasonal Weather Forecast Summary
      • Special Weather Forecast Summary
    • Cropping Calendar: support for one (1) crop (Rice)
    • Crop Recommendations Generator
      • Seasonal Climate Outlook and Advisory Recommendations (using month, crop stages, and rainfall conditions as triggers)
      • 10-Day Farm Weather Outlook and Advisory Recommendations (using current date and crop stage/s as triggers)
    • PDF Bulletins Downloads
  6. Admin Pages
    • Crop Recommendations Management
      • Regional Seasonal Climate Outlook and Advisory PDF Bulletins and Reports Creator
      • 10-Day Farm Outlook and Weather Advisory PDF Bulletins and Reports Creator
      • Special Weather Forecast PDF Bulletins and Reports Creator
      • View created reports/bulletins list
      • View a created report/bulletin
    • SMS Management
      • Phonebook
      • Send SMS
    • ACAP Settings
      • Weather Forecast Data Management
        • PAGASA seasonal weather forecast Excel file uploader
        • Manual weather systems input editor
      • 10-Day Weather Forecast Data Management
        • PAGASA 10-Day weather forecast Excel files uploader
        • Manual moon phases input editor
      • Cyclone Typhoon Advisory Data Management
        • Manual trigger of syncing the PAGASA Severe Tropical Cyclone web page data
        • Manual wind speed list and affected municipalities editor
      • User Profile Management
  7. Cloud deployment setup to development and production environments using GitHub Actions
    • Automatic deployment to Heroku/Render (backend) and Firebase Hosting/GitHub Pages (frontend)
  8. Docker setup for development and Render deployment
  9. REST API Endpoints
    • A set of secure and authenticated REST API endpoints for allowing signed-in admins to mutate ACAP data over HTTPS
    • Processes the seasonal/10-day weather forecast Excel file uploads
  10. Cron Jobs (NPM scripts) for Automatic Weather Forecast Data Syncing to the ACAP Database
  • Daily 10-Day Weather Forecast Excel Files from PAGASA data syncing
  • Weekly El Nino/La Nina PAGASA web page contents syncing
  • Regular daily syncing of PAGASA's Severe Tropical Cyclone Bulletin web page
  1. Data Processing and Upload Scripts
  • NPM scripts for uploading cropping calendar data (CSV file) and crop recommendations (Excel file) to the database
  • NPM scripts for seeding the Firestore database with default data
  1. Software development planning documentation (available at link (opens in a new tab)).

June 2023 onwards

Changed

  • Used .env variables to manage region-specific static text in the front end, ensuring the base model of the application can be easily adapted for multiple regions with different text content requirements, allowing easier regional static text replacement.

  • Use nda values for null/empty seasonal weather forecast data in the backend and front end, borrowed from the ongoing ACAP-RCMAS API development.

Fixed

  • Various bug fixes and minor updates with summary in the climate-services-webportal-v1 (ACAP 1.0 repository) Releases (opens in a new tab) page for more information.