CSC/ECE 517 Fall 2023 - E2383. Grading Audit Trail

From Expertiza_Wiki
Revision as of 06:53, 3 December 2023 by Ealopezg (talk | contribs)
Jump to navigation Jump to search

Introduction

Problem Statement

After an instructor gave a grade to an assignment, there is no way to track who gave the grade. A grading audit trail must be created and the following information needs to be stored:

1. When a grade is assigned by an instructor, there needs to be an indication of who did it and when it was done.
2. Comments previously provided by other instructors must also be preserved.

This information needs to be stored every time an instructor edits a grade/comment and clicks the save button.

There have been previous attempts from teams to implement such functionality and our implementation will be based on E1934 and E2237. Each of these implementations have problems of their own that we need to address.

Overview of Major Changes By Previous Teams

E1934

Their Screencast

  • Created a database called grading_history to store elements for the Grading Audit Trail (instructor id, assignment id, grade tyoe, student id, grade, comment and timestamp)
  • Used MVC design to create a model, a controller, and a view for both of Review Grade and Submission Grade. These will be the links used in the View Submissions view and View Review Report view so that the grading trail for an assignments submission and reviews are seperate.
  • Modified grades controller, so that every time, a grade is submitted or edited, grading_history_controller.rb will call a method to create an entry that saves into the database.

Problems/Issues

1. For review grades, the “Grading History” link must not be in a separate column. It should be in :smaller text below the in the “Save” button.
2. In the view grading record page, remove the receiver column and add it to the title
3. Restrict the column width on the grading record page
4. Add comments on list_submissions.html.erb to indicate that the alignment was changed to fix code climate issues
5. Ensure that white space changes are separate commits
6. Revert changes made to list_review_mapping.html.erb
7. Remove the review_report_html.erb file
8. Design doc – mention why each of those files were changed

E2237

  • They fixed some issues that were causing the system to crash during testing
  • Altered the Grading History view
  • Explained the reasoning for changes made to files using diagrams and justifications

Problems/Issues

1. Redundant files generated by scaffolding need to be removed, along with debugging code. Ex) Coffee created by scaffolding and console logging for debugging.
2. Authentication could be done using existing utilities, no need to create their own.
3. Some formatting changes could be done especially on how cells span in review report page. Ex) Formatting change for spans in between cells in review report.
4. Code from previous implementation is a concern.

Proposed Solution

We plan on using the implementation of E2237 since it is the latest in the Grading Audit Trail projects and has the latest in terms of testing. These files cannot be added haphazardly since parts of the implementation is a cause to concern and caused the changes to not be implemented. It is also using an older version of expertiza so some parts may not be compatible.

We must first figure out exactly what changes and issues to address in their implementation by meeting with our mentor. We also need to reimplement the following files since none of their changes were implemented:

  • app/controllers/grading_histories_controller.rb

    Calls the grading history view after validating Submission and Review Type.

  • app/models/grading_history.rb

    Model for Grading History.

  • app/models/review_grading_history.rb

    Model containing specifics of Review Grading History. Inherits Grading History.

  • app/models/submission_grading_history.rb

    Model containing specifics of Submission Grading History. Inherits Grading History.

  • app/views/grading_history/index_html.erb

    This is a view for grading audit trail, it will display all grading histories of a 
    submission/review

  • spec/features/grade_histories_spec.rb

    Feature test to check if the grades appear in chronological order

  • spec/features/helpers/grade_histories_helper.rb

    Helper file to facilitate the above mentioned feature test.

Reimplementation

Since the previous teams implementations were not integrated we have to reimplement the main idea of theirs again which we will do by looking at their commits and pull request to see what files are necessary and what can be left out to address the issues of their implementation.

The files that are included already and we plan to alter without a doubt are

  • app/views/reports/_review_report.html.erb

    This is the view in which we will need to add a link to the Grade History/Record for reviews

Reimplemented

  • app/controllers/grading_histories_controller.rb

    This file was added because it was from the previous teams implementation which concerned the MVC of the grading_history they created. It dealt with allowing only the correct people to view the grading history, checking the assignment type whether it be a submission or review, and indexing all the grading history for the assignment in chronological order.

  • app/models/grading_history.rb

    This file was added to follow the previous teams MVC of the grading_history they created.

  • app/models/review_grading_history.rb

    This file was reimplemented to follow the previous teams MVC of the ReviewGradingHistory

  • app/models/submission_grading_history.rb

    This file was reimplemented to follow the previous teams MVC of the SubmisionGradingHistory

Modified

  • app/controllers/grades_controller.rb

    This file was modified based off the previous teams implementation because when the method save_grade_and_comment_for_submission was called it should also create a grading history so that the grading audit can be created and added to. This was mainly focusing on the grading history of submissions and not reviews.

  • app/controllers/review_mapping_controller.rb

    This file was modified based off the previous teams implementation because when the method save_grade_and_comment_for_reviewer was called it should also create a grading history so that the grading audit can be created and added to. This was mainly focusing on the grading history of reviews and not submissions.

  • app/views/assignments/list_submissions.html.erb

    It was modified to add the new hyperlink to display the grading history of a submission.

  • config/routes.rb

    It was to add the new route for grading histories

Solution - Implemented

Testing Plan

The Testing that we will implement will build from E2237 since the previous tests crash and was something they solved. We also plan to implement test using the given Test Skeleton.

Future Scope

This project may need further improvement since it does not seem like there should be an abundance of files added and perhaps using the MVC design is not necessarily needed.

Relevant Links

Contributors to this project

  • Amulya Usem
  • Erik Lopez-Godinez
  • Gowtham Pollam
  • Mentor: Srilekha Gudipati