Application: email-alert-api

Sends email alerts to the public for GOV.UK

• GitHub: email-alert-api
• Ownership: #interaction-and-personalisation-govuk
• Hosting: AWS, on the email_alert_api machine class
• Category: APIs
• Rake tasks: Run a Rake task on Integration, Staging or ⚠️ Production ⚠️
• Links:
  • Sentry (error tracking)
  • Puppet configuration
  • Deploy scripts
  • Deployment dashboard
  • Metrics dashboard

Imported documents

• Analytics
• Available endpoints
• Data cleanup mechanisms
• ENV vars
• Load test Email Alert API
• Matching content to subscriber lists
• Receive emails from Email Alert API in Integration and Staging
• Send a bulk email
• Support tasks
• /adr
• 5. Record architecture decisions
• 6. Email Delivery Responsibilities
• 7. Retain data for up to one year
• 8. Monitoring and alerting
• 9. Sidekiq Lost Job Recovery
• Decision Record: Initial Data Retention Strategy
• Decision Record: Initial architecture for Notify integration
• Decision Record: MVP implementation of Digests
• Decision Record: Message Concept
• Decision record: reinstate unpublish emails for single page subscriptions

README

Sends emails to users that subscribe to specific GOV.UK email alerts.

Provides a consistent internal interface to external email notification services. Currently supports only GOV.UK Notify.

Nomenclature

• Content change:

  • A publication event that creates or changes a content item
  • The representation of that event for the purpose of sending emails

• Message:

  • A message, distinct from a content change, that can be sent to subscribers of a list
  • The representation of that event for the purpose of sending emails

• Subscriber list:

  • A particular titled list that a user can sign up to
  • Contains criteria to determine which notifications a subscriber will receive (eg. all publications by HMRC)

• Subscriber:

  • A user who has subscribed to one or more subscriber lists

• Subscription:

  • The relationship between a subscriber and the subscription lists they are subscribed to

• Digest run:

  • One batch of either daily or weekly digests representing a particular subscription that has a start and end time and a set of subscribers to send emails to

• Email:

  • An email generated from content changes or messages to be sent to subscribers

Technical documentation

This is a Ruby on Rails app, and should follow our Rails app conventions.

You can use the GOV.UK Docker environment to run the application and its tests with all the necessary dependencies. Follow the usage instructions to get started.

Use GOV.UK Docker to run any commands that follow.

Running the test suite

bundle exec rake

Further documentation

Check the docs/ directory for detailed instructions, decisions and other documentation.

Licence

MIT License