CSC/ECE 517 Fall 2022 - E2284. Calibration submissions should be copied along with calibration assignments

Introduction

A “calibration assignment” is an assignment where the students are asked to review work that has also been reviewed by a member of the course staff. If the student’s review “resembles” the staff member’s review, then the student is presumed to be a competent reviewer. Here is a further description of calibration assignments. The instructor (or TA) adds a few extra participants to the assignment to set up calibration. The instructor (or TA) then impersonates the extra participants and submits work on behalf of each of the extra participants.

Problem Statement

As of now, when one clicks on the copy button next to the assignment and a copy is created, you can observe that the calibration tab of the copied assignment renders no results at all. An empty table is shown

Having the instructor (or TA) impersonate the extra participants, and submit work on behalf of each of the extra participants is extra trouble. It would be nice if an instructor didn’t have to resubmit the same calibration submissions every semester. Copying the extra participants along with their teams, submissions, and responses when copying an assignment makes things much easier.

Previous Submission

What was Done

They created a new class method that checks if the an assignment was calibrated and if it was, it calls methods from models. It performs the following:

1. They copy all submission records with the assignment_id matching the original assignment.
2. Copy all participants with the parent_id matching the original assignment ID.
3. Copy all the teams with a parent_id matching the original assignment ID.
4. Recreated mappings needed to associate participants with teams and review_response maps.
   1. Their copy methods for teams and participants return hash maps that are used to lookup previous mappings.
   2. Create new TeamsUsers. Associates participants with teams.
      1. Create new ReviewResponseMap. Associates reviewers and reviewees, linked to an assignment, together.
5. Copy all review_responses, using the original review response map as the reference.

Their 'copy_calibrated_reviews' is called in the existing assignment_form class method 'copy', if the copied assignment is able to be saved (to avoid creating new records).

They also added methods for copy naming schemes so that the assignment model validates uniqueness of both the assignment name and directory_path.

Issues

Issue 1: Not all uses of class methods are good.

• self.copy_participants_for_assignment: copies old participants to new --> assignment_participant.rb, it is in teams_users.rb, which seems misplaced.

Issue 2: Returns a mapping from the old response map to the new response map.

• self.copy_review_response_map, returns a mapping from the old response map to the new response map. It is in review_response_map.rb. This can be an instance method. There is a copy_review_responses in this class too.

Issue 3: Code missing without causing a bug

• Line 65 of submit_hyperlink has missing code.

Issue 4: Old code not reused.

• New code was written to copy a team in teams_user.rb. There already exists code to copy a team.

Issue 5: No Automated tests written

Files Changed

assignment_form.rb

• Added a new method "copy_name" to name copied assignments. Where they changed the name of the copied assignments to “copy of copy” and "copy of copy of copy", etc to "Copy of <name> <copy number>"
• Added new method for copying objects needed to recreate calibration reviews

participant.rb

• Wrote a "createparticipant" method in assignment_participant in place of a similar method in participant.rb

response.rb

• Implemented a method for copying previous responses

response_map.rb

• Implemented a method to create ReviewResponse mapping based on mapping of copied assignment

submission_record.rb

• Added method for copying submission records of an assignment

teams_user.rb

• Added a method to create new teams_users so that new participants and teams are associated the same way they were for the previous assignment

assignment_participant.rb

• Added a method for copying extra participants, to not copy participants with type 'CourseParticipant'

Design

Principles we plan to use

1. DRY: We intend to write code that is written only once and utilised wherever needed.
2. Single Responsibility: Our modules, classes and functions would have one responsibility.
3. Open-Closed: We would try to ensure that there would be minimum necessity to modify our code and at the same time make sure that there is an opportunity for extension.
4. Law of Demeter: Our classes would be written in such a way that they do not have knowledge of the internal working of other objects. They would not manipulate other objects.
5. Maximize Cohesion and minimize coupling: Our modules would be written to have low dependency on other modules while depending highly on its member functions.

Proposed Workflow

Pseudocode

1. Get all SubmissionRecords with assignment_id = old_assignment_id
2. For each submission_record
   1. Create duplicate new_submission_record from submission_record
   2. Set new_submission_record.assignment_id = new_assignment_id
   3. Save new_submission_record
3. Get all teams with parent_id = old_assignment_id
4. For each team
   1. Create duplicate new_team from team
   2. Set new_team.parent_id = new_assignment_id
   3. Save new_team
   4. Copy members of team to new_team
   5. Get ReviewResponseMap with reviewee_id = team
   6. For each review_response_map
      1. Create duplicate new_review_response_map from review_response_map
      2. Set new_review_response_map.reviewed_object_id = new_assignment_id
      3. Set new_review_response_map.reviewee_id = new_team.id
      4. Save the new_review_response_map
      5. Get all Responses with map_id = review_response_map.id
      6. For each response
         1. Create duplicate new_response from response
         2. Set new_response.map_id = new_review_response_map.id
         3. Save new_response
5. Get all participants with parent_id = old_assignment_id
6. For each participant
   1. Create duplicate new_participant
   2. Set new_participant.parent_id = new_assignment_id
   3. Save new_participant

Planned Code Changes

app/models/assignment.rb

1. Add an instance method copy_calibrated_responses_from(old_assignment) that copies submissions, teams, participants, and responses from a calibrated assignment to the assignment instance.
2. Add an instance method copy_submissions_from(old_assignment) that copies SubmissionRecords from the old_assignment to the assignment.
3. Add an instance method copy_participants_from(old_assignment) that copies Participants from the old_assignment to the assignment.

app/models/team.rb

1. Add a method get_review_response_mappings() that retrieves all ReviewResponseMappings associated to a team.

app/models/review_response_map.rb

1. Add a method get_response() that retrieves the response for the review response mapping.

Test Plan

Testing Goals

 The main goal of our testing is to ensure that when a new calibration assignment is added, all of the qualifying previous calibration submissions 
 and reviews are successfully copied over without overwriting any existing submissions.

Automated Testing using Rspec

Context

When the original assignment to be copied is a calibrated assignment

Behaviors to Verify

For the copied assignment, we need to verify if:

1. All the submission records are copied from the old assignment to the new assignment.

2. Extra participants are copied.

3. All review responses are copied.

Manual UI Testing

This feature is accessible only by an instructor.

1. Log in as an instructor.

2. Go to Assignments and select an existing assignment.

3. Make sure that the assignment has a calibration tab since this feature handles only calibration assignments.

4. Click on the copy option next to the assignment name and this creates a copy of the assignment and a number is appended to the name in order to name the new copied assignment.

5. After the successful implementation of the feature, you should be able to click on the calibration tab of the copied assignment and this should enlist all the participants, submissions, and reviews.

6. This shows that the feature of copying submissions from old calibration assignments to new calibration assignments was successful.

Team Information

Mentor

Dr. Ed Gehringer (efg@ncsu.edu)

Team Members

Pradyumna Khawas (ppkhawas@ncsu.edu)
Abhimanyu Bellam (abellam2@ncsu.edu)
Vishnu Vinod Erapalli (verapal@ncsu.edu)