Finished phase006

app/models/maintenance_entry.rb

@@ -20,9 +20,9 @@ class MaintenanceEntry < ApplicationRecord
     return if vehicle.blank? || name.blank?
 
     scheduled = vehicle.maintenance_schedules.any? do |schedule|
-      schedule.maintenance_type.casecmp?(name)
+      schedule.active? && schedule.maintenance_type.casecmp?(name)
     end
-    scheduled ||= vehicle.maintenance_schedules.where("lower(maintenance_type) = ?", name.downcase).exists? if vehicle.persisted?
+    scheduled ||= vehicle.maintenance_schedules.active.where("lower(maintenance_type) = ?", name.downcase).exists? if vehicle.persisted?
     return if scheduled
 
     errors.add(:name, "must match a maintenance schedule for the vehicle")

app/models/maintenance_notification.rb

@@ -0,0 +1,18 @@
+class MaintenanceNotification
+  NOTIFIABLE_STATUSES = %w[upcoming overdue].freeze
+
+  def self.record_status_change(schedule, status)
+    return if schedule.last_status == status.status
+
+    previous_status = schedule.last_status.presence || "unknown"
+    schedule.update!(last_status: status.status, last_status_changed_at: Time.current)
+    return unless NOTIFIABLE_STATUSES.include?(status.status)
+
+    Rails.logger.warn(
+      "Maintenance schedule #{status.status}: vehicle_id=#{schedule.vehicle_id} " \
+        "maintenance_schedule_id=#{schedule.id} maintenance_type=#{schedule.maintenance_type.inspect} " \
+        "previous_status=#{previous_status} due_odometer=#{status.due_odometer} due_date=#{status.due_date} " \
+        "reason=#{status.reason.inspect}"
+    )
+  end
+end

app/models/maintenance_schedule.rb

@@ -4,4 +4,18 @@ class MaintenanceSchedule < ApplicationRecord
   validates :maintenance_type, presence: true, uniqueness: { scope: :vehicle_id, case_sensitive: false }
   validates :mileage_interval, presence: true, numericality: { only_integer: true, greater_than: 0 }
   validates :time_interval, presence: true, numericality: { only_integer: true, greater_than: 0 }
+  validates :baseline_odometer, presence: true, numericality: { only_integer: true, greater_than_or_equal_to: 0 }
+  validates :baseline_date, presence: true
+  validates :active, inclusion: { in: [ true, false ] }
+  validate :baseline_date_cannot_be_in_the_future
+
+  scope :active, -> { where(active: true) }
+
+  private
+
+  def baseline_date_cannot_be_in_the_future
+    return if baseline_date.blank? || baseline_date <= Date.current
+
+    errors.add(:baseline_date, "can't be in the future")
+  end
 end

app/models/maintenance_schedule_status.rb

@@ -0,0 +1,110 @@
+class MaintenanceScheduleStatus
+  UPCOMING_PERCENT = 0.05
+
+  attr_reader :schedule, :latest_entry, :status, :due_odometer, :due_date
+
+  def initialize(schedule, latest_entry, current_odometer:)
+    @schedule = schedule
+    @latest_entry = latest_entry
+    @current_odometer = current_odometer
+    @due_odometer = baseline_odometer + schedule.mileage_interval
+    @due_date = baseline_date + schedule.time_interval.days
+    @status = calculate_status
+  end
+
+  def overdue?
+    status == "overdue"
+  end
+
+  def upcoming?
+    status == "upcoming"
+  end
+
+  def no_history?
+    status == "no_history"
+  end
+
+  def current?
+    status == "current"
+  end
+
+  def status_label
+    case status
+    when "overdue" then "Overdue"
+    when "upcoming" then "Upcoming"
+    when "no_history" then "No history"
+    else "Current"
+    end
+  end
+
+  def reason
+    case status
+    when "overdue"
+      overdue_reasons.join(" and ")
+    when "upcoming"
+      upcoming_reasons.join(" and ")
+    when "no_history"
+      "No matching maintenance entry has been recorded."
+    else
+      "Maintenance is current."
+    end
+  end
+
+  private
+
+  attr_reader :current_odometer
+
+  def calculate_status
+    return "overdue" if mileage_overdue? || time_overdue?
+    return "upcoming" if mileage_upcoming? || time_upcoming?
+    return "no_history" if latest_entry.blank?
+
+    "current"
+  end
+
+  def baseline_odometer
+    latest_entry&.odometer || schedule.baseline_odometer
+  end
+
+  def baseline_date
+    latest_entry&.date || schedule.baseline_date
+  end
+
+  def mileage_overdue?
+    current_odometer >= due_odometer
+  end
+
+  def time_overdue?
+    Date.current >= due_date
+  end
+
+  def mileage_upcoming?
+    current_odometer >= due_odometer - mileage_upcoming_window
+  end
+
+  def time_upcoming?
+    Date.current >= due_date - time_upcoming_window.days
+  end
+
+  def mileage_upcoming_window
+    (schedule.mileage_interval * UPCOMING_PERCENT).ceil
+  end
+
+  def time_upcoming_window
+    (schedule.time_interval * UPCOMING_PERCENT).ceil
+  end
+
+  def overdue_reasons
+    reasons = []
+    reasons << "mileage interval reached" if mileage_overdue?
+    reasons << "time interval reached" if time_overdue?
+    reasons
+  end
+
+  def upcoming_reasons
+    reasons = []
+    reasons << "within #{mileage_upcoming_window} miles of due odometer" if mileage_upcoming?
+    reasons << "within #{time_upcoming_window} days of due date" if time_upcoming?
+    reasons
+  end
+end