Update dates validation message when iteration dates overlap

With introduction of multiple iteration cadences we can be
a bit more specific with the overlapping dates validation
message.

https://gitlab.com/gitlab-org/gitlab/-/issues/299312

ee/app/models/ee/iteration.rb

@@ -212,10 +212,11 @@ module EE
       return unless iterations_cadence
       return unless iterations_cadence.iterations.where.not(id: self.id).within_timeframe(start_date, due_date).exists?
 
-      # for now we only have a single default cadence within a group just to wrap the iterations into a set.
-      # once we introduce multiple cadences per group we need to change this message.
-      # related issue: https://gitlab.com/gitlab-org/gitlab/-/issues/299312
-      errors.add(:base, s_("Iteration|Dates cannot overlap with other existing Iterations within this group"))
+      if group.iteration_cadences_feature_flag_enabled?
+        errors.add(:base, s_("Iteration|Dates cannot overlap with other existing Iterations within this iterations cadence"))
+      else
+        errors.add(:base, s_("Iteration|Dates cannot overlap with other existing Iterations within this group"))
+      end
     end
 
     def future_date

ee/spec/models/ee/iteration_spec.rb

@@ -178,53 +178,46 @@ RSpec.describe Iteration do
         let(:start_date) { 5.days.from_now }
         let(:due_date) { 6.days.from_now }
 
-        shared_examples_for 'overlapping dates' do |skip_constraint_test: false|
-          context 'when start_date overlaps' do
-            let(:start_date) { 5.days.from_now }
-            let(:due_date) { 3.weeks.from_now }
+        shared_examples_for 'overlapping dates' do
+          shared_examples_for 'invalid dates' do
+            context 'with iterations_cadences FF disabled' do
+              before do
+                stub_feature_flags(iteration_cadences: false)
+              end
+
+              it 'is not valid' do
+                expect(subject).not_to be_valid
+                expect(subject.errors[:base]).to include('Dates cannot overlap with other existing Iterations within this group')
+              end
+            end
+
+            it 'is not valid even if forced' do
+              subject.validate # to generate iid/etc
+              expect { subject.save!(validate: false) }.to raise_exception(ActiveRecord::StatementInvalid, /#{constraint_name}/)
+            end
 
             it 'is not valid' do
               expect(subject).not_to be_valid
-              expect(subject.errors[:base]).to include('Dates cannot overlap with other existing Iterations within this group')
+              expect(subject.errors[:base]).to include('Dates cannot overlap with other existing Iterations within this iterations cadence')
             end
+          end
 
-            unless skip_constraint_test
-              it 'is not valid even if forced' do
-                subject.validate # to generate iid/etc
-                expect { subject.save!(validate: false) }.to raise_exception(ActiveRecord::StatementInvalid, /#{constraint_name}/)
-              end
-            end
+          context 'when start_date overlaps' do
+            let(:start_date) { 5.days.from_now }
+            let(:due_date) { 3.weeks.from_now }
+
+            it_behaves_like 'invalid dates'
           end
 
           context 'when due_date overlaps' do
             let(:start_date) { Time.current }
             let(:due_date) { 6.days.from_now }
 
-            it 'is not valid' do
-              expect(subject).not_to be_valid
-              expect(subject.errors[:base]).to include('Dates cannot overlap with other existing Iterations within this group')
-            end
-
-            unless skip_constraint_test
-              it 'is not valid even if forced' do
-                subject.validate # to generate iid/etc
-                expect { subject.save!(validate: false) }.to raise_exception(ActiveRecord::StatementInvalid, /#{constraint_name}/)
-              end
-            end
+            it_behaves_like 'invalid dates'
           end
 
           context 'when both overlap' do
-            it 'is not valid' do
-              expect(subject).not_to be_valid
-              expect(subject.errors[:base]).to include('Dates cannot overlap with other existing Iterations within this group')
-            end
-
-            unless skip_constraint_test
-              it 'is not valid even if forced' do
-                subject.validate # to generate iid/etc
-                expect { subject.save!(validate: false) }.to raise_exception(ActiveRecord::StatementInvalid, /#{constraint_name}/)
-              end
-            end
+            it_behaves_like 'invalid dates'
           end
         end
 

ee/spec/requests/api/graphql/mutations/iterations/update_spec.rb

@@ -109,7 +109,16 @@ RSpec.describe 'Updating an Iteration' do
           let_it_be(:another_iteration) { create(:iteration, group: group, start_date: start_date.strftime('%F'), due_date: end_date.strftime('%F') ) }
 
           it_behaves_like 'a mutation that returns errors in the response',
-                          errors: ["Dates cannot overlap with other existing Iterations within this group"]
+                          errors: ["Dates cannot overlap with other existing Iterations within this iterations cadence"]
+
+          context 'with iterations_cadences FF disabled' do
+            before do
+              stub_feature_flags(iteration_cadences: false)
+            end
+
+            it_behaves_like 'a mutation that returns errors in the response',
+              errors: ["Dates cannot overlap with other existing Iterations within this group"]
+          end
         end
       end
 

locale/gitlab.pot

@@ -18496,6 +18496,9 @@ msgstr ""
 msgid "Iteration|Dates cannot overlap with other existing Iterations within this group"
 msgstr ""
 
+msgid "Iteration|Dates cannot overlap with other existing Iterations within this iterations cadence"
+msgstr ""
+
 msgid "Iteration|cannot be more than 500 years in the future"
 msgstr ""