Class: CompletionKit::Metric

Inherits:
ApplicationRecord show all
Includes:
Taggable
Defined in:
app/models/completion_kit/metric.rb

Constant Summary collapse

DEFAULT_RUBRIC_BANDS = 
[
  { "stars" => 5, "description" => "Fully meets or exceeds all criteria. No meaningful issues." },
  { "stars" => 4, "description" => "Meets criteria well. Minor issues only." },
  { "stars" => 3, "description" => "Meets criteria adequately. Some room for improvement." },
  { "stars" => 2, "description" => "Partially meets criteria. Significant gaps or frequent errors." },
  { "stars" => 1, "description" => "Fails to meet the criteria. Major errors or completely off-target." }
].freeze

Constants inherited from ApplicationRecord

ApplicationRecord::TenantScopedUniquenessValidator

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Taggable

#tag_names, #tag_names=

Class Method Details

.default_rubric_bands ⇒ Object 



26
27
28
 
# File 'app/models/completion_kit/metric.rb', line 26

def self.default_rubric_bands
  DEFAULT_RUBRIC_BANDS.map(&:dup)
end

.default_rubric_text ⇒ Object 



30
31
32
 
# File 'app/models/completion_kit/metric.rb', line 30

def self.default_rubric_text
  rubric_text_for(default_rubric_bands)
end

.normalize_rubric_bands(raw_bands) ⇒ Object 



42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
 
# File 'app/models/completion_kit/metric.rb', line 42

def self.normalize_rubric_bands(raw_bands)
  bands = raw_bands.is_a?(Hash) ? raw_bands.values : Array(raw_bands)
  band_map = bands.each_with_object({}) do |band, acc|
    next unless band.respond_to?(:to_h)

    normalized = band.to_h.stringify_keys.slice("stars", "description")
    stars = normalized["stars"].to_i
    next unless (1..5).cover?(stars)

    acc[stars] = {
      "stars" => stars,
      "description" => normalized["description"].to_s.strip
    }
  end

  default_rubric_bands.map do |default_band|
    stars = default_band["stars"]
    band = band_map[stars]
    {
      "stars" => stars,
      "description" => band && band["description"].present? ? band["description"] : default_band["description"]
    }
  end
end

.rubric_text_for(bands) ⇒ Object 



34
35
36
37
38
39
40
 
# File 'app/models/completion_kit/metric.rb', line 34

def self.rubric_text_for(bands)
  Array(bands).sort_by { |b| -(b["stars"] || 0) }.map do |band|
    stars = band["stars"].to_i
    label = stars == 1 ? "1 star" : "#{stars} stars"
    "#{label}: #{band["description"]}"
  end.join("\n\n")
end

Instance Method Details

#as_json(options = {}) ⇒ Object 



75
76
77
78
79
80
81
82
 
# File 'app/models/completion_kit/metric.rb', line 75

def as_json(options = {})
  {
    id: id, name: name, key: key, instruction: instruction,
    rubric_bands: rubric_bands,
    created_at: created_at, updated_at: updated_at,
    tags: tags.as_json
  }
end

#display_rubric_text ⇒ Object 



71
72
73
 
# File 'app/models/completion_kit/metric.rb', line 71

def display_rubric_text
  self.class.rubric_text_for(rubric_bands_for_form)
end

#rubric_bands_for_form ⇒ Object 



67
68
69
 
# File 'app/models/completion_kit/metric.rb', line 67

def rubric_bands_for_form
  self.class.normalize_rubric_bands(rubric_bands)
end