Auto-scheduled monthly announcement (#10975)

> [!NOTE]
> These announcements do not show up on the announcements overview until
they are published or updated.

---------

Co-authored-by: Gary Tou <[email protected]>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Author: 3 people

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