Skip to content

AtlasOfLivingAustralia/alerts

Repository files navigation

ALA Alerts

This is a small app responsible for sending email alerts when there are changes detected to endpoint web services (subscriptions).

Scheduling is handled by Quartz plugin in the app. It works like RSS - it checks the JSON service and reads the results and then compares that with the previously stored check and if there are new records, it triggers an email. Relies on records being sorted by date loaded. Works with any endpoint that can return date-sorted JSON output.

Build status

Build Status

Dev environment set up

  1. Install MySql
  2. Log in as root
  3. create user 'alerts_user'@'localhost' identified as 'alerts_user';
  4. grant all privileges on *.* to 'alerts_user'@'localhost';
  5. create database alerts
  6. Create /data/alerts/config/alerts-config.properties
  7. Use the template in ala-install to get the necessary values

To check email sending on local dev environment

Run smtp4dev via Docker:

docker run -p 3000:80 -p 2525:25 -d --name smtpdev rnwood/smtp4dev

Emails will be sent on SMTP port 2525 (configure sending emails via postie.enableEmail=true, grails.mail.port=2525 and grails.mail.server=localhost. Note: emails will not be delivered externally so you don't have to worry about spamming users.

You can view all sent emails via the smtp4dev UI on http:https://localhost:3000/, inlcuding HTML emails which are nicely displayed.