From 573f62c3b45fe55632a640bb9041de6f8dde16a3 Mon Sep 17 00:00:00 2001
From: Jorge Manrubia <jorge@37signals.com>
Date: Fri, 5 Sep 2025 17:23:26 +0200
Subject: [PATCH] Add comment

---
 app/models/period_highlights.rb | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/app/models/period_highlights.rb b/app/models/period_highlights.rb
index 72ebfa476..e78c4d937 100644
--- a/app/models/period_highlights.rb
+++ b/app/models/period_highlights.rb
@@ -1,3 +1,7 @@
+# Contains a summary for a given set of events. You create these summaries with a time window
+# and a set of collections. We only store a key derived from the accessible events for those collections,
+# so that we reuse the same summary for users with different time zones or different accesses as long as the activity
+# is the same. This is important to keep AI costs down.
 class PeriodHighlights < ApplicationRecord
   class << self
     def create_or_find_for(collections, starts_at:, duration: 1.week)