Auto-scheduled monthly announcement

app/controllers/events_controller.rb

@@ -1023,7 +1023,8 @@ def event_params
         :id,
         :anonymous_donations,
         :cover_donation_fees,
-        :contact_email
+        :contact_email,
+        :generate_monthly_announcement
       ]
     )
 
@@ -1071,7 +1072,8 @@ def user_event_params
         :id,
         :anonymous_donations,
         :cover_donation_fees,
-        :contact_email
+        :contact_email,
+        :generate_monthly_announcement
       ]
     )
 

app/jobs/announcement/monthly_job.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+class Announcement
+  class MonthlyJob < ApplicationJob
+    queue_as :default
+
+    def perform
+      Announcement.monthly_for(Date.today.prev_month).find_each do |announcement|
+        Rails.error.handle do
+          announcement.publish!
+        end
+      end
+
+      Event.includes(:config).where(config: { generate_monthly_announcement: true }).find_each do |event|
+        Announcement::Templates::Monthly.new(event:, author: User.system_user).create
+      end
+    end
+
+  end
+
+end

app/jobs/announcement/seven_day_warning_job.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+class Announcement
+  class SevenDayWarningJob < ApplicationJob
+    queue_as :low
+
+    def perform
+      Announcement.monthly_for(Date.today).where.not(aasm_state: :published).find_each do |announcement|
+        AnnouncementMailer.with(announcement:).seven_day_warning.deliver_now
+      end
+    end
+
+  end
+
+end

app/jobs/announcement/two_day_warning_job.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+class Announcement
+  class TwoDayWarningJob < ApplicationJob
+    queue_as :low
+
+    def perform
+      Announcement.monthly_for(Date.today).where(aasm_state: :template_draft).find_each do |announcement|
+        AnnouncementMailer.with(announcement:).two_day_warning.deliver_now
+      end
+    end
+
+  end
+
+end

app/mailers/announcement_mailer.rb

@@ -1,11 +1,31 @@
 # frozen_string_literal: true
 
 class AnnouncementMailer < ApplicationMailer
+  before_action :set_warning_variables, only: [:seven_day_warning, :two_day_warning]
+
   def announcement_published
     @announcement = params[:announcement]
     @event = @announcement.event
 
     mail to: params[:email], subject: "#{@announcement.title} | #{@event.name}", from: hcb_email_with_name_of(@event)
   end
 
+  def seven_day_warning
+    mail to: @emails, subject: "[#{@event.name}] Your scheduled monthly announcement will be delivered on #{@scheduled_for.strftime("%b %-m")}"
+  end
+
+  def two_day_warning
+    mail to: @emails, subject: "[#{@event.name}] Your scheduled monthly announcement will be delivered on #{@scheduled_for.strftime("%b %-m")}"
+  end
+
+  def set_warning_variables
+    @announcement = params[:announcement]
+    @event = @announcement.event
+
+    @emails = @event.managers.map(&:email_address_with_name)
+    @emails << @event.config.contact_email if @event.config.contact_email.present?
+
+    @scheduled_for = Date.today.next_month.beginning_of_month
+  end
+
 end

app/models/announcement.rb

@@ -11,6 +11,7 @@
 #  published_at        :datetime
 #  rendered_email_html :text
 #  rendered_html       :text
+#  template_type       :string
 #  title               :string           not null
 #  created_at          :datetime         not null
 #  updated_at          :datetime         not null
@@ -55,6 +56,9 @@ class Announcement < ApplicationRecord
     end
   end
 
+  scope :saved, -> { where.not(aasm_state: :template_draft) }
+  scope :monthly, -> { where(template_type: Announcement::Templates::Monthly.name) }
+  scope :monthly_for, ->(date) { monthly.where("announcements.created_at BETWEEN ? AND ?", date.beginning_of_month, date.end_of_month) }
   validate :content_is_json
 
   scope :saved, -> { where.not(aasm_state: :template_draft).where.not(content: {}) }

app/models/announcement/templates/blank.rb

@@ -24,7 +24,7 @@ def json_content
       end
 
       def create
-        Announcement.create!(event: @event, title:, content: json_content, aasm_state: :template_draft, author: @author)
+        Announcement.create!(event: @event, title:, content: json_content, aasm_state: :template_draft, author: @author, template_type: self.class.name)
       end
 
     end

app/models/announcement/templates/donation_goal_reached.rb

@@ -51,7 +51,7 @@ def json_content
       end
 
       def create
-        Announcement.create!(event: @event, title:, content: json_content, aasm_state: :template_draft, author: @author)
+        Announcement.create!(event: @event, title:, content: json_content, aasm_state: :template_draft, author: @author, template_type: self.class.name)
       end
 
     end

app/models/announcement/templates/monthly.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+class Announcement
+  module Templates
+    class Monthly
+      include ApplicationHelper
+
+      def initialize(event:, author:)
+        @event = event
+        @author = author
+      end
+
+      def title
+        "#{Date.current.strftime("%B %Y")} Update"
+      end
+
+      def json_content(block)
+        {
+          type: "doc",
+          content: [
+            { type: "paragraph", content: [{ type: "text", text: "Hey all!" }] },
+            {
+              type: "paragraph",
+              content: [
+                {
+                  type: "text",
+                  text: "Thank you for your support and generosity! With this funding, we'll be able to better work towards our mission.",
+                },
+              ],
+            },
+            {
+              type: "paragraph",
+              content: [
+                {
+                  type: "text",
+                  text: "We'd like to thank all of the donors from the past month that contributed towards our organization:",
+                },
+              ],
+            },
+            { type: "donationSummary", attrs: { id: block.id } },
+            {
+              type: "paragraph",
+              content: [
+                { type: "text", text: "Best," },
+                { type: "hardBreak" },
+                { type: "text", text: "The #{@event.name} team" },
+              ],
+            },
+          ],
+        }
+      end
+
+      def create
+        announcement = Announcement.create!(event: @event, title:, content: {}, aasm_state: :template_draft, author: @author, template_type: self.class.name)
+        block = Announcement::Block::DonationSummary.create!(announcement:, parameters: { start_date: Date.current.beginning_of_month })
+        announcement.update!(content: json_content(block))
+      end
+
+    end
+
+  end
+
+end

app/models/announcement/templates/new_donation_tier.rb

@@ -75,7 +75,7 @@ def json_content
       end
 
       def create
-        Announcement.create!(event: @donation_tier.event, title:, content: json_content, aasm_state: :template_draft, author: @author)
+        Announcement.create!(event: @donation_tier.event, title:, content: json_content, aasm_state: :template_draft, author: @author, template_type: self.class.name)
       end
 
     end

app/models/announcement/templates/new_mission_statement.rb

@@ -46,7 +46,7 @@ def json_content
       end
 
       def create
-        Announcement.create!(event: @event, title:, content: json_content, aasm_state: :template_draft, author: @author)
+        Announcement.create!(event: @event, title:, content: json_content, aasm_state: :template_draft, author: @author, template_type: self.class.name)
       end
 
     end

app/models/announcement/templates/new_team_member.rb

@@ -48,7 +48,7 @@ def json_content
       end
 
       def create
-        Announcement.create!(event: @invite.event, title:, content: json_content, aasm_state: :template_draft, author: @author)
+        Announcement.create!(event: @invite.event, title:, content: json_content, aasm_state: :template_draft, author: @author, template_type: self.class.name)
       end
 
     end

app/models/event.rb

@@ -376,6 +376,7 @@ class Event < ApplicationRecord
   after_validation :move_friendly_id_error_to_slug
 
   after_update :generate_stripe_card_designs, if: -> { attachment_changes["stripe_card_logo"].present? && stripe_card_logo.attached? && !Rails.env.test? }
+  before_save :enable_monthly_announcements
 
   comma do
     id
@@ -834,4 +835,11 @@ def enforce_transparency_eligibility
     end
   end
 
+  def enable_monthly_announcements
+    # We'll enable monthly announcements when transparency mode is turned on
+    if is_public_changed?(to: true)
+      config.update(generate_monthly_announcement: true)
+    end
+  end
+
 end

app/models/event/configuration.rb

@@ -4,13 +4,14 @@
 #
 # Table name: event_configurations
 #
-#  id                  :bigint           not null, primary key
-#  anonymous_donations :boolean          default(FALSE)
-#  contact_email       :string
-#  cover_donation_fees :boolean          default(FALSE)
-#  created_at          :datetime         not null
-#  updated_at          :datetime         not null
-#  event_id            :bigint           not null
+#  id                            :bigint           not null, primary key
+#  anonymous_donations           :boolean          default(FALSE)
+#  contact_email                 :string
+#  cover_donation_fees           :boolean          default(FALSE)
+#  generate_monthly_announcement :boolean          default(FALSE), not null
+#  created_at                    :datetime         not null
+#  updated_at                    :datetime         not null
+#  event_id                      :bigint           not null
 #
 # Indexes
 #
@@ -26,6 +27,14 @@ class Configuration < ApplicationRecord
     validates_email_format_of :contact_email, allow_nil: true, allow_blank: true
     normalizes :contact_email, with: ->(contact_email) { contact_email.strip.downcase }
 
+    after_create :set_defaults
+
+    private
+
+    def set_defaults
+      self.generate_monthly_announcement = event.is_public unless self.generate_monthly_announcement.present?
+    end
+
   end
 
 end

app/views/announcement_mailer/_announcement.html.erb

@@ -0,0 +1,3 @@
+<h1><%= @announcement.title %></h1>
+
+<%= @announcement.render_email.html_safe %> <%# erb_lint:disable ErbSafety %>

app/views/announcement_mailer/_explanation.html.erb

@@ -0,0 +1,4 @@
+<p>
+  Announcements are a feature where you can send out updates to users following your organization.
+  You are receiving this message because you have auto-scheduled monthly announcements enabled in your organization settings.
+</p>

app/views/announcement_mailer/announcement_published.html.erb

@@ -1,6 +1,5 @@
-<h1><%= @announcement.title %></h1>
+<%= render "announcement_mailer/announcement" %>
 
-<%= @announcement.render_email.html_safe %> <%# erb_lint:disable ErbSafety %>
 <br>
 <i><%= link_to "View this announcement in your browser", @announcement %></i>
 <br>

app/views/announcement_mailer/seven_day_warning.html.erb

@@ -0,0 +1,19 @@
+<h1>A scheduled announcement will go out in 7 days</h1>
+
+<%= render "announcement_mailer/explanation" %>
+
+<i><%= link_to "Update the announcement and share what your organization has been working on here", @announcement %></i>
+
+<br>
+<br>
+
+<div class="card shadow-none border">
+  <%= render "announcement_mailer/announcement" %>
+</div>
+
+<br>
+
+<p>
+  From,<br>
+  The HCB Team
+</p>

app/views/announcement_mailer/two_day_warning.html.erb

@@ -0,0 +1,19 @@
+<h1>A scheduled announcement will go out in 2 days</h1>
+
+<%= render "announcement_mailer/explanation" %>
+
+<i><%= link_to "Update the announcement and share what your organization has been working on here", @announcement %></i>
+
+<br>
+<br>
+
+<div class="card shadow-none border">
+  <%= render "announcement_mailer/announcement" %>
+</div>
+
+<br>
+
+<p>
+  From,<br>
+  The HCB Team
+</p>

app/views/events/settings/_details.html.erb

@@ -160,6 +160,25 @@
     <%= form.submit "Update", disabled: %>
   </div>
 
+  <h3 class="mb1" id="announcements_heading">Announcements</h3>
+  <div class="card mb3" data-controller="accordion">
+    <div class="field field--checkbox">
+      <span style="font-weight: 700">Generate monthly announcements</span>
+      <div class="field--checkbox--switch ml-auto">
+        <%= form.fields_for :config do |config| %>
+          <%= config.label :generate_monthly_announcement do %>
+            <%= config.check_box :generate_monthly_announcement, data: { action: "change->accordion#toggle", target: "accordion.checkbox" }, disabled:, switch: true %>
+            <span class="slider"></span>
+          <% end %>
+        <% end %>
+      </div>
+    </div>
+    <p class="h5 muted mt0 mb1">
+      Use this to enable auto-scheduled monthly announcements.
+    </p>
+    <%= form.submit "Update", disabled: %>
+  </div>
+
   <h3 class="mb1" id="cards_heading">Contact information</h3>
   <div class="card mb3">
     <div class="field">

config/schedule.yml

@@ -217,6 +217,18 @@ monthly_follower_summary_job:
   cron: "0 0 1 * *" # run first day of each month
   class: "MonthlyFollowerSummaryJob"
 
+announcement_monthly_job:
+  cron: "0 0 1 * *" # run first day of each month
+  class: "Announcement::MonthlyJob"
+
+announcement_seven_day_warning_job:
+  cron: "0 12 -7 * *" # run at 8am ET; 7 days before the end of the month
+  class: "Announcement::SevenDayWarningJob"
+
+announcement_two_day_warning_job:
+  cron: "0 12 -2 * *" # run at 8am ET; 2 days before the end of the month
+  class: "Announcement::TwoDayWarningJob"
+
 delete_old_template_drafts_job:
   cron: "0 0 1 * *" # run first day of each month
   class: "DeleteOldTemplateDraftsJob"

db/migrate/20250716200152_add_template_to_announcements.rb

@@ -0,0 +1,5 @@
+class AddTemplateToAnnouncements < ActiveRecord::Migration[7.2]
+  def change
+    add_column :announcements, :template_type, :string
+  end
+end