No-new-work weeks on the calendar

A checkbox under each week number flags the week "no new work" and circles
it in red. New appointments in a flagged week (or ones moved or lengthened
into it) warn on the form and are stopped on save; users with "Override
no-new-work weeks" can tick "Schedule anyway". Flagging needs "Flag
no-new-work weeks". Call-outs aren't affected. Adds migration 005.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
rickyandClaude Opus 5.5 committed 2026-11-06 10:16:10 -05:00
1 parent cba0057c9c
commit 9a07c16731
13 files changed
+304 -5

No files matched your search

+37
View File
@@ -34,6 +34,13 @@ class CustomerAppointment < ActiveRecord::Base
# The hours can't be less than the attached estimate's labor hours
validate :validate_hours_cover_estimate
# New work landing in a week flagged "no new work" needs an override (see #no_work_week_override)
validate :validate_no_work_weeks
# Set by the controller when the user ticked "Schedule anyway" and holds the "Override no-new-work weeks"
# permission
attr_accessor :no_work_week_override
# Capitalize the first letter only; titleize mangled vehicle names and acronyms (JL -> Jl, LED -> Led)
normalizes :subject, with: ->(subject) { subject.strip.sub(/\A[a-z]/, &:upcase) }
@@ -104,6 +111,24 @@ class CustomerAppointment < ActiveRecord::Base
subject
end
# The Mondays of flagged no-new-work weeks this appointment adds work to: weeks its working days fall in
# that it didn't already cover before this change. Call-outs aren't work, so never any.
def no_work_weeks_added
return [] if call_out? || date.blank?
weeks = NoWorkWeek.flagged_week_starts(working_days)
if persisted? && date_in_database.present? && event_type_in_database != CALL_OUT
previous = RedmineQboCalendar::WorkingDays.dates(date_in_database.to_date, duration_in_database)
weeks -= previous.map { |d| NoWorkWeek.week_start_for(d) }
end
weeks.sort
end
# True after validation stopped the save over a no-new-work week, so the form can offer "Schedule anyway"
def no_work_week_conflict?
@no_work_week_conflict == true
end
# The estimate's labor hours rounded up to whole hours (appointment hours are whole numbers): the
# quantities of its lines with redmine_qbo's labor products/services (e.g. Labor). 0 if the
# estimate can't be read from QuickBooks.
@@ -148,6 +173,18 @@ class CustomerAppointment < ActiveRecord::Base
errors.add(:base, I18n.t(:error_hours_less_than_estimate, hours: labor, estimate: estimate.doc_number))
end
def validate_no_work_weeks
@no_work_week_conflict = false
return if no_work_week_override
return unless new_record? || will_save_change_to_date? || will_save_change_to_duration? || will_save_change_to_event_type?
weeks = no_work_weeks_added
return if weeks.empty?
@no_work_week_conflict = true
errors.add(:base, I18n.t(:error_no_work_week, weeks: weeks.map { |w| I18n.l(w, format: :long) }.to_sentence))
end
# Validates that the appointment date does not land on a weekend or holiday
def validate_working_day
return if date.blank?
+45
View File
@@ -0,0 +1,45 @@
# The MIT License (MIT)
#
# Copyright (c) 2026 rick barrette
#
# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
# A week flagged "no new work" on the calendar. Weeks are keyed by their Monday, so the flag holds whatever
# day the user's calendar starts its rows on.
class NoWorkWeek < ApplicationRecord
belongs_to :user, optional: true
validates :week_start, presence: true, uniqueness: true
# The Monday of the week a date is in
def self.week_start_for(date)
date.to_date.beginning_of_week(:monday)
end
# The Mondays of the flagged weeks among the given dates' weeks, read in one query
def self.flagged_week_starts(dates)
starts = Array(dates).compact.map { |d| week_start_for(d) }.uniq
return Set.new if starts.empty?
where(week_start: starts).pluck(:week_start).to_set
end
# Whether any of the dates falls in a flagged week
def self.flagged?(*dates)
flagged_week_starts(dates.flatten).any?
end
def self.flag!(date, user = User.current)
find_or_create_by!(week_start: week_start_for(date)) { |w| w.user = user if user&.logged? }
rescue ActiveRecord::RecordNotUnique
find_by(week_start: week_start_for(date))
end
def self.unflag!(date)
where(week_start: week_start_for(date)).delete_all
end
end