adds time estimate to task definitions

app/api/entities/task_definition_entity.rb

@@ -44,5 +44,13 @@ def staff?(my_role)
     expose :overseer_image_id, if: ->(unit, options) { staff?(options[:my_role]) }
     expose :assessment_enabled, if: ->(unit, options) { staff?(options[:my_role]) }
     expose :moss_language, if: ->(unit, options) { staff?(options[:my_role]) }
+
+    expose :estimated_days do |task_def, options|
+      task_def.estimated_days || (task_def.estimated_time_minutes.to_i / 60 / 24)
+    end
+
+    expose :estimated_hours do |task_def, options|
+      task_def.estimated_hours || ((task_def.estimated_time_minutes.to_i / 60) % 24)
+    end
   end
 end

app/api/task_definitions_api.rb

@@ -33,6 +33,8 @@ class TaskDefinitionsApi < Grape::API
       optional :assessment_enabled,       type: Boolean,  desc: 'Enable or disable assessment'
       optional :overseer_image_id,        type: Integer,  desc: 'The id of the Docker image for overseer'
       optional :moss_language,            type: String,   desc: 'The language to use for code similarity checks'
+      optional :estimated_days,           type: Integer,  desc: 'Estimated time to complete task, measured in days'
+      optional :estimated_hours,          type: Integer,  desc: 'Estimated time to complete task, measured in hours'
     end
   end
   post '/units/:unit_id/task_definitions/' do
@@ -61,12 +63,18 @@ class TaskDefinitionsApi < Grape::API
                                                 :max_quality_pts,
                                                 :assessment_enabled,
                                                 :overseer_image_id,
-                                                :moss_language
+                                                :moss_language,
+                                                :estimated_days,
+                                                :estimated_hours
                                               )
 
     task_params[:unit_id] = unit.id
     task_params[:upload_requirements] = JSON.parse(params[:task_def][:upload_requirements]) unless params[:task_def][:upload_requirements].nil?
 
+    days = task_params.delete(:estimated_days).to_i
+    hours = task_params.delete(:estimated_hours).to_i
+    task_params[:estimated_time_minutes] = (days * 24 * 60) + (hours * 60)
+
     task_def = TaskDefinition.new(task_params)
 
     # Set the tutorial stream
@@ -111,6 +119,8 @@ class TaskDefinitionsApi < Grape::API
       optional :assessment_enabled,       type: Boolean,  desc: 'Enable or disable assessment'
       optional :overseer_image_id,        type: Integer,  desc: 'The id of the Docker image name for overseer'
       optional :moss_language,            type: String,   desc: 'The language to use for code similarity checks'
+      optional :estimated_days,           type: Integer,  desc: 'Estimated time to complete task, measured in days'
+      optional :estimated_hours,          type: Integer,  desc: 'Estimated time to complete task, measured in hours'
     end
   end
   put '/units/:unit_id/task_definitions/:id' do
@@ -138,11 +148,17 @@ class TaskDefinitionsApi < Grape::API
                                                 :max_quality_pts,
                                                 :assessment_enabled,
                                                 :overseer_image_id,
-                                                :moss_language
+                                                :moss_language,
+                                                :estimated_days,
+                                                :estimated_hours
                                               )
 
     task_params[:upload_requirements] = JSON.parse(params[:task_def][:upload_requirements]) unless params[:task_def][:upload_requirements].nil?
 
+    days = task_params.delete(:estimated_days).to_i
+    hours = task_params.delete(:estimated_hours).to_i
+    task_params[:estimated_time_minutes] = (days * 24 * 60) + (hours * 60)
+
     # Ensure changes to a TD defined as a "draft task definition" are validated
     if unit.draft_task_definition_id == params[:id]
       if params[:task_def][:upload_requirements]

db/migrate/20260326104829_add_estimated_time_minutes_to_task_definitions.rb

@@ -0,0 +1,9 @@
+class AddEstimatedTimeMinutesToTaskDefinitions < ActiveRecord::Migration[7.1]
+  def up
+    add_column :task_definitions, :estimated_time_minutes, :integer, null: true, default: 0, comment: "Estimated time to complete task, measured in minutes"
+  end
+
+  def down
+    remove_column :task_definitions, :estimated_time_minutes
+  end
+end

db/schema.rb

@@ -10,7 +10,7 @@
 #
 # It's strongly recommended that you check this file into your version control system.
 
-ActiveRecord::Schema[7.1].define(version: 2024_05_28_223908) do
+ActiveRecord::Schema[7.1].define(version: 2026_03_26_104829) do
   create_table "activity_types", charset: "utf8", collation: "utf8_unicode_ci", force: :cascade do |t|
     t.string "name", null: false
     t.string "abbreviation", null: false
@@ -250,6 +250,7 @@
     t.bigint "overseer_image_id"
     t.string "tii_group_id"
     t.string "moss_language"
+    t.integer "estimated_time_minutes", default: 0, comment: "Estimated time to complete task, measured in minutes"
     t.index ["group_set_id"], name: "index_task_definitions_on_group_set_id"
     t.index ["overseer_image_id"], name: "index_task_definitions_on_overseer_image_id"
     t.index ["tutorial_stream_id"], name: "index_task_definitions_on_tutorial_stream_id"