E2476 student_team_controller.rb file created

app/controllers/api/v1/student_teams_controller.rb

@@ -0,0 +1,120 @@
+class Api::V1::StudentTeamsController < ApplicationController
+  include StudentTeamsHelper
+
+  rescue_from ActiveRecord::RecordNotFound, with: :record_not_found
+  rescue_from ActionController::ParameterMissing, with: :parameter_missing
+
+  before_action :set_student, only: %i[view create remove_participant add_participant]
+
+  # GET /api/v1/student_teams
+  # Retrieve all student teams information
+  def index
+    fetch_all_teams_and_participants all_teams
+  end
+
+  # GET /student_teams/:id
+  # Show details of a specific student team
+  def show
+    fetch_team_and_participants current_team
+  rescue ActiveRecord::RecordNotFound => e
+    render json: { error: e.message }, status: :not_found
+  end
+
+  # POST /student_teams
+  # Create a new team for the student
+  def create
+    team_name = params[:team][:name].presence || generate_team_name
+    existing_teams = AssignmentTeam.where(name: team_name, assignment_id: @student.assignment_id)
+
+    if existing_teams.empty?
+      parent = Assignment.find_by(id: @student.assignment_id)
+      team = AssignmentTeam.new(name: team_name, assignment_id: @student.assignment_id)
+      if parent&.auto_assign_mentor
+        team = team.upgrade_to_mentored_team
+      end
+      if team.save
+        user = User.find(@student.user_id)
+        team.add_member(user, team.assignment_id)
+        fetch_team_and_participants team, :created
+      else
+        render json: team.errors, status: :unprocessable_entity
+      end
+    else
+      render json: { error: 'That team name is already in use.' }, status: :unprocessable_entity
+    end
+  end
+
+  # PATCH/PUT /student_teams
+  # Update team details: name
+  def update
+    team = AssignmentTeam.find(params[:team_id])
+    team_name = params[:team][:name]
+    if team_name.blank?
+      return render json: { error: 'Team name cannot be empty.' }, status: :unprocessable_entity
+    end
+
+    matching_teams = AssignmentTeam.where(name: team_name, assignment_id: team.assignment.id)
+    success_response = -> { render json: { message: "The team: '#{team.name}' has been updated successfully." }, status: :ok }
+    if matching_teams.empty?
+      if team.update(name: team_name)
+        success_response.call
+      else
+        render json: { error: team.errors.full_messages }, status: :unprocessable_entity
+      end
+    elsif matching_teams.length == 1 && matching_teams.first.name == team.name
+      success_response.call
+    else
+      render json: { error: 'That team name is already in use.' }, status: :unprocessable_entity
+    end
+  rescue ActiveRecord::RecordNotFound
+    render json: { error: "AssignmentTeam with id #{params[:team_id]} not found." }, status: :not_found
+  end
+
+  # DELETE /student_teams/:id
+  # Delete a specific team
+  def destroy
+    team = AssignmentTeam.find(params[:id])
+    if team.destroy
+      head :no_content
+    else
+      render json: { error: 'Failed to delete team.' }, status: :unprocessable_entity
+    end
+  rescue ActiveRecord::RecordNotFound
+    render json: { error: "AssignmentTeam with id #{params[:id]} not found." }, status: :not_found
+  end
+
+  # DELETE /student_teams/:id/remove_participant
+  # Remove a participant from the team
+  def remove_participant
+    begin
+      team = AssignmentTeam.find(params[:id])
+      destroyed, message = team.remove_team_user(user_id: @student.user_id)
+      Invitation.where(from_user: @student, assignment: @student.assignment_id).destroy_all
+      render json: { message: message }, status: destroyed ? :no_content : :not_found
+
+  rescue ActiveRecord::RecordNotFound => e
+      render json: { message: 'Team not found.' }, status: :not_found
+    end
+  end
+
+  # PATCH /student_teams/:id/add_participant
+  # Add a participant to the team
+  def add_participant
+    team = AssignmentTeam.find_by(id: params[:id])
+    if team.nil?
+      render json: { error: "Team with id #{params[:id]} not found" }, status: :not_found
+    else
+      user = User.find(@student.user_id)
+      begin
+        team.add_member(user, team.assignment_id)
+        if team.save
+          fetch_team_and_participants team
+        else
+          render json: team.errors, status: :unprocessable_entity
+        end
+      rescue => e
+        render json: { error: e.message }, status: :unprocessable_entity 
+      end
+    end
+  end
+end

app/helpers/student_teams_helper.rb

@@ -0,0 +1,59 @@
+module StudentTeamsHelper
+    private
+
+    def set_team
+      @team = AssignmentTeam.find(params[:team_id])
+    end
+
+    def all_teams
+      AssignmentTeam.all
+    end 
+
+    def current_team
+      AssignmentTeam.find(params[:id])
+    end
+
+    def set_student
+      @student = AssignmentParticipant.find(params[:student_id])
+    end
+
+    def generate_team_name
+      loop do
+        suffix = rand(1..999)
+        team_name = "Team_#{suffix}"
+        break team_name unless AssignmentTeam.exists?(name: team_name)
+      end
+    end
+
+    def record_not_found(exception)
+      if exception.model == 'AssignmentTeam'
+        render json: { error: 'Team id not found.' }, status: :not_found
+      elsif exception.model == 'AssignmentParticipant'
+        render json: { error: 'User id not found.' }, status: :not_found
+      else
+        render json: { error: 'Record not found.' }, status: :not_found
+      end
+    end
+
+    def parameter_missing(exception)
+      render json: { error: "Parameter missing: #{exception.param}" }, status: :unprocessable_entity
+    end
+
+    def fetch_team_and_participants(team, status = :ok)
+      participants = team.assignment_participants
+      team_json = team.as_json
+      team_json[:participants] = participants.map { |participant| { student_id: participant.id } }
+      render json: team_json, status: status
+    end
+
+    def fetch_all_teams_and_participants(teams, status = :ok)
+      teams = teams.map do |team|
+        # Convert the team object to a JSON hash
+        team_json = team.as_json
+        # Append the participants to the team JSON hash
+        team_json[:participants] = team.assignment_participants.map { |participant| { student_id: participant.id } }
+        team_json
+      end
+      render json: { teams: teams }, status: status
+    end
+  end

app/models/assignment_team.rb

@@ -0,0 +1,74 @@
+class AssignmentTeam < Team
+
+  # Get Participants of the team
+  def assignment_participants
+    users = self.users
+    participants = []
+    users.each do |user|
+      participant = AssignmentParticipant.find_by(user_id: user.id, assignment_id: self.assignment.id)
+      participants << participant unless participant.nil?
+    end
+    participants
+  end
+
+  def add_participant(assignment_id, user)
+    return if AssignmentParticipant.find_by(assignment_id: assignment_id, user_id: user.id)
+
+    AssignmentParticipant.create(assignment_id: assignment_id, user_id: user.id)
+  end
+
+  def received_any_peer_review?
+    ResponseMap.where(reviewee_id: id, reviewed_object_id: self.assignment.id).any?
+  end
+
+  # Prototyping AssignmenTeam to MentoredTeam
+  # TODO :: Assign mentor once MentorManagement is implemented
+  def upgrade_to_mentored_team
+    # Duplicate AssignmentTeam
+    mentored_team = self.dup
+
+    # Dynamically hook into add_member logic to invoke MentorManagement if can add member
+    mentored_team.define_singleton_method(:add_member) do |user, assignment_id|
+      # Call the original implementation with the arguments
+      can_add_member = super(user, assignment_id)
+      # Mentor Management is not yet implemented, so having to comment this line
+      # MentorManagement.assign_mentor(_assignment_id, id) if can_add_member
+      can_add_member
+    end
+
+    # Return overridden team
+    mentored_team
+  end
+
+  private
+
+  def dup
+    ActiveRecord::Base.transaction do
+      # Duplicate the team itself
+      duplicated_team = self.dup
+      duplicated_team.save!
+
+      # Duplicate associated signed_up_teams
+      self.signed_up_teams.each do |signed_up_team|
+        duplicated_team.signed_up_teams.create!(signed_up_team.attributes.except("id", "team_id", "created_at", "updated_at"))
+      end
+
+      # Duplicate associated teams_users and retain user associations
+      self.teams_users.each do |teams_user|
+        duplicated_team_user = duplicated_team.teams_users.create!(teams_user.attributes.except("id", "team_id", "created_at", "updated_at"))
+        duplicated_team_user.user = teams_user.user # Reassociate the existing user
+        duplicated_team_user.save!
+      end
+
+      # Duplicate participants
+      self.participants.each do |participant|
+        duplicated_team.participants.create!(participant.attributes.except("id", "team_id", "created_at", "updated_at"))
+      end
+
+      duplicated_team
+    end
+  rescue => e
+    Rails.logger.error("Failed to duplicate team: #{e.message}")
+    raise ActiveRecord::Rollback
+  end
+end

app/models/team.rb

@@ -17,4 +17,59 @@ def full?
       false
     end
   end
+
+  def self.size(team_id)
+    #TeamsUser.where(team_id: team_id).count
+    count = 0
+    members = TeamsUser.where(team_id: team_id)
+    members.each do |member|
+      member_name = member.name
+      unless member_name.include?(' (Mentor)') 
+        count = count + 1
+      end
+    end
+    count
+  end
+
+  # Add member to the team, changed to hash by E1776
+  def add_member(user, _assignment_id)
+    raise "The user #{user.name} is already a member of the team #{name}" if user?(user)
+
+    can_add_member = false
+    unless full?
+      can_add_member = true
+      t_user = TeamsUser.create(user_id: user.id, team_id: self.id)
+      add_participant(_assignment_id, user)
+    end
+    can_add_member
+  end
+
+  def user?(user)
+    users.include? user
+  end
+
+  # TODO :: Remove the team from waitlist, once Waitlist is implemented
+  def remove_team_user(user_id:)
+    if TeamsUser.exists?(team_id: self.id, user_id: user_id)
+      TeamsUser.where(team_id: self.id, user_id: user_id).destroy_all
+    else
+      return [false, "Student does not belong to team #{self.id}"]
+    end
+
+    # if this user is the last member of the team then the team does not
+    # have any members, delete the entry for the team
+    # puts TeamsUser.where(team_id: self.id).inspect
+    if TeamsUser.where(team_id: self.id).empty?
+      old_team = AssignmentTeam.find self.id
+      if (old_team && Team.size(old_team.id) == 0 && !old_team.received_any_peer_review?)
+        old_team.destroy
+        return [true, "Team #{self.id} is destroyed as the last user is removed"]
+        # if assignment has signup sheet then the topic selected by the team has to go back to the pool
+        # or to the first team in the waitlist
+        # Waitlist.remove_from_waitlists(team_id)
+      end
+    end
+    return [true, "Participant Removed Successfully"]
+  end
+
 end

config/routes.rb

@@ -53,6 +53,20 @@
         end
       end
 
+      resources :student_teams do
+        member do
+          get :show
+          delete :destroy
+        end
+        collection do
+          get :index
+          post :create
+          patch :update
+          delete ':id/remove_participant',action: :remove_participant
+          patch ':id/add_participant', action: :add_participant
+        end
+      end
+
       resources :courses do
         collection do
           get ':id/add_ta/:ta_id', action: :add_ta

db/migrate/20241201203840_create_assignment_teams.rb

@@ -0,0 +1,8 @@
+class CreateAssignmentTeams < ActiveRecord::Migration[7.0]
+  def change
+    create_table :assignment_teams do |t|
+
+      t.timestamps
+    end
+  end
+end

db/migrate/20241201220020_add_auto_assign_mentor_to_assignments.rb

@@ -0,0 +1,5 @@
+class AddAutoAssignMentorToAssignments < ActiveRecord::Migration[7.0]
+  def change
+    add_column :assignments, :auto_assign_mentor, :boolean
+  end
+end

db/migrate/20241201221122_add_type_to_teams.rb

@@ -0,0 +1,5 @@
+class AddTypeToTeams < ActiveRecord::Migration[7.0]
+  def change
+    add_column :teams, :type, :string
+  end
+end

db/migrate/20241202002102_add_name_to_teams.rb

@@ -0,0 +1,5 @@
+class AddNameToTeams < ActiveRecord::Migration[7.0]
+  def change
+    add_column :teams, :name, :string
+  end
+end