CSC/ECE 517 Fall 2017/E1797 Timestamps for students submissions

Objective

To develop a feature for Expertiza to visualize the timeline using student submission timestamps, thereby enabling the student to navigate to the submissions records easily.

Problem Statement

The instructor can see the submission records of students currently as a table for each assignment. But, student can't see the timestamps of submissions and deadlines of the assignment easily. In this project student should be able to visualize the submission records as a timeline, which includes

• Timestamps of hyperlink submission records
• Timestamps of file upload record
• Due Dates
• Peer review link with round number and timestamps
• Author feedback to other’s review link with feedback hyperlink, timestamps

This project proposes a solution to include the timeline with all the hyperlinks necessary.

Use Case Diagram

1. Viewing the timeline

• Use case id:1
• Use case description: View timeline in 'Your work' page of selected assignment
• Actor: Student
• Precondition: Student should be logged into Expertiza
• Post condition: Student can view the due dates and timestamps of the activities, if any.

2. Viewing the due dates

• Use case id:2
• Use case description: View due dates only when no submissions have been made
• Actor: Student
• Precondition: Student should be logged into Expertiza, should be in 'Your work' page of selected assignment
• Post condition: Student will view only dues dates in timeline when no submissions are made.

3. Viewing hyperlink submissions in timeline

• Use case id:3
• Use case description: View hyperlink with timestamp upon submission
• Actor: Student
• Precondition: Student should be logged into Expertiza, should be in 'Your work' page of selected assignment, should have made a hyperlink submission
• Post condition: Student will view hyperlink of the submitted link with timestamp in timeline

4. Viewing files uploaded in timeline

• Use case id:4
• Use case description: View file name with timestamp upon submission
• Actor: Student
• Precondition: Student should be logged into Expertiza, should be in 'Your work' page of selected assignment, should have submitted a file
• Post condition: Student will view file name with timestamp in timeline and would be able to download the file upon clicking on filename.

5. Viewing links to submitted reviews with round number

• Use case id:5
• Use case description: View review links with timestamp upon submission
• Actor: Student
• Precondition: Student should be logged into Expertiza, should be in 'Your work' page of selected assignment, should have submitted a review
• Post condition: Student will view review link with timestamp and round number in timeline and would be redirected to the review submission upon clicking on the link.

6. Viewing links to author feedback

• Use case id:6
• Use case description: View author feedback links with timestamp upon submission
• Actor: Student
• Precondition: Student should be logged into Expertiza, should be in 'Your work' page of selected assignment, should have submitted an author feedback
• Post condition: Student will view author feedback link with timestamp in timeline and would be redirected to the author feedback submission upon clicking on the link.

Design Analysis

Currently when a student logs into Expertiza, he could see the student task list page. He could access them by following the path

• Login → Assignments → Choose a particular Assignment

In this project a time line in the student task list page would be added to navigate student to the due dates and the necessary links easily and keep a track of them. After the addition of the functionality, the student task list page would have the timeline as shown below.(Actual visualization of the page might differ from the static page displayed). We will be using HighGraphs to generate the timeline.

Files involved

• app/controllers/submission_records_controller.rb
• app/models/submission_record.rb
• app/views/student_task/list.html.erb
• The database tables involved for the work is review mappings table, response table, due dates table
• Due Dates will be taken from Due Dates table which has topic Id and assignment Id
• Review Mapping table will be used for the review ID
• Files and the Hyperlinks submitted will be taken from teams table
• New Reviews will be looked in from Response table

Test Plan

TDD

For testing the new functionality TDD approach will be followed. Test cases for the functioning of the timeline would be added before development and would be implemented in the project to make tests pass. student_submission_timestamps_spec.rb would be created and the tests are run.

UI Testing

The newly added functionality would be tested manually by the UI testing. The time line added should show the deadlines and the recently made changes to the project by reviewer or the author. It should also navigate author to the page he wants through the preview link provided for each stage in timeline.