Expertiza_Wiki - User contributions [en]

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-06T17:02:57Z

Vjsangha:

=Expertiza - Information Display and Student Interaction=

Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged===
<ul>
<li>
Model
</li>
questionnaire_type_node.rb
<li>
View
</li>
grades/view_my_scored.html.erb, tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
grades_controller.rb, questionnaires_controller.rb, tree_display_controller.rb
<li>
Database
</li>
db/schema.rb
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Changes made for the project
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> questionnaire_type_node.rb </code>
| Model
| Made code changes for searching within a course when required
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades/view_my_scores.html.erb </code>
| View
| Made changes to display tables and the charts generated by the grades_controller
|-
|style="text-align:center;"|''''' 3 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Added an icon for navigation to questionnaires for a given course.
|-
|-
|style="text-align:center;"|''''' 4 '''''
| <code> grades_controller.rb </code>
| Controller
| Table data and graph generation code added so that the grades for the entire class are calculated.
|-
|style="text-align:center;"|''''' 5 '''''
| <code> questionnaires_controller.rb </code>
| Controller
| Added a short method to redirect control with the correct parameters when questionnaires are loaded.
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display_controller.rb </code>
| Controller
| Added some code in the search method to allow searching for questionnaires either by course or in general.
|}

= Screenshots =
1) Better display for assignments: 
A new icon for questionnaires added 
[[File:new_icon_view.png|center|frame]] 
On click of icon it will display questionnaires related to the selected course 
[[File:questionnaires_view.png|center|frame]] 
It also allows to search questionnaires based on name. Here we searched word "wiki", It shows result of the search.
[[File:wiki_search.jpg|center|frame]] 
2) Dashboard for students: 
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

=Steps to check the new implementations=

== The new Student dashboard ==
Sample Test case.
 1. Log-in to Expertiza as an student (Username: user480, Password: password).
 2. Click on 'Program 1: BackChannel' assignment.
 3. Click on the option 'Your Scores'.
 4. The dashboard is then displayed with the class statistics along with the new graph added.

== The Questionnaire search ==
 1. Log-in to Expertiza as an instructor (Username: user2, Password: password).
 2. Enter any string in the search box
 3. We would be able to see all the questionnaires that have the entered string as a substring in them.

== The Course specific questionnaire list ==
Sample Test case.
 1. Log-in to Expertiza as an instructor (Username: user2, Password: password).
 2. Expand the Courses option.
 3. Hover over the Course actions menu for the course 'CSC 517, Spring 2014'.
 4. Click on the menu-item that says 'View Questionnaires'.
 5. List of questionnaires would be displayed here.
 6. Search within the above list of questionnaires is also possible by using the search given in the page.

='''References'''=
<references/>

File:Wiki search.jpg

2014-12-05T19:03:11Z

Vjsangha:

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-05T19:02:38Z

Vjsangha: /* Screenshots */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged===
<ul>
<li>
Model
</li>
questionnaire_type_node.rb
<li>
View
</li>
grades/view_my_scored.html.erb, tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
grades_controller.rb, questionnaires_controller.rb, tree_display_controller.rb
<li>
Database
</li>
db/schema.rb
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Changes made for the project
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> questionnaire_type_node.rb </code>
| Model
| Made code changes for searching within a course when required
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades/view_my_scores.html.erb </code>
| View
| Made changes to display tables and the charts generated by the grades_controller
|-
|style="text-align:center;"|''''' 3 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Added an icon for navigation to questionnaires for a given course.
|-
|-
|style="text-align:center;"|''''' 4 '''''
| <code> grades_controller.rb </code>
| Controller
| Table data and graph generation code added so that the grades for the entire class are calculated.
|-
|style="text-align:center;"|''''' 5 '''''
| <code> questionnaires_controller.rb </code>
| Controller
| Added a short method to redirect control with the correct parameters when questionnaires are loaded.
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display_controller.rb </code>
| Controller
| Added some code in the search method to allow searching for questionnaires either by course or in general.
|}

= Screenshots =
1) Better display for assignments: 
A new icon for questionnaires added 
[[File:new_icon_view.png|center|frame]] 
On click of icon it will display questionnaires related to the selected course 
[[File:questionnaires_view.png|center|frame]] 
It also allows to search questionnaires based on name. Here we searched word "wiki", It shows result of the search.
[[File:wiki_search.jpg|center|frame]] 
2) Dashboard for students: 
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

=Steps to check the new implementations=

== The new Student dashboard ==
Sample Test case.
 1. Log-in to Expertiza as an student (Username: user480, Password: password).
 2. Click on 'Program 1: BackChannel' assignment.
 3. Click on the option 'Your Scores'.
 4. The dashboard is then displayed with the class statistics along with the new graph added.

== The Questionnaire search ==
 1. Log-in to Expertiza as an instructor (Username: user2, Password: password).
 2. Enter any string in the search box
 3. We would be able to see all the questionnaires that have the entered string as a substring in them.

== The Course specific questionnaire list ==
Sample Test case.
 1. Log-in to Expertiza as an instructor (Username: user2, Password: password).
 2. Expand the Courses option.
 3. Hover over the Course actions menu for the course 'CSC 517, Spring 2014'.
 4. Click on the menu-item that says 'View Questionnaires'.
 5. List of questionnaires would be displayed here.
 6. Search within the above list of questionnaires is also possible by using the search given in the page.

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T04:49:57Z

Vjsangha: /* Functionality of each file */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
questionnaire_type_node.rb
<li>
View
</li>
grades\view_my_scored.html.erb, tree_display/actions/_courses_actions.html.erb, tree_display/_page_header.html.erb
<li>
Controller
</li>
grades_controller.rb, questionnaires_controller.rb, tree_display_controller.rb
<li>
Database
</li>
db/schema.rb
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> questionnaire_type_node.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display/_page_header.html.erb </code>
| View
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|-
|style="text-align:center;"|''''' 5 '''''
| <code> grades_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 6 '''''
| <code> questionnaires_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 7 '''''
| <code> tree_display_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 8 '''''
| <code> schema.rb </code>
| Database
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
1) Better display for assignments: 
A new icon for questionnaires added 
[[File:new_icon_view.png|center|frame]] 
On click of icon it will display questionnaires related to the selected course 
[[File:questionnaires_view.png|center|frame]] 
2) Dashboard for students: 
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

=Steps to check the new implementations=

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T04:37:54Z

Vjsangha: /* Functionality of each file */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
questionnaire_type_node.rb
<li>
View
</li>
grades\view_my_scored.html.erb, tree_display/actions/_courses_actions.html.erb, tree_display/_page_header.html.erb
<li>
Controller
</li>
grades_controller.rb, questionnaires_controller.rb, tree_display_controller.rb
<li>
Database
</li>
db/schema.rb
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> questionnaire_type_node.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display/_page_header.html.erb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|-
|style="text-align:center;"|''''' 5 '''''
| <code> grades_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 6 '''''
| <code> questionnaires_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 7 '''''
| <code> tree_display_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 8 '''''
| <code> schema.rb </code>
| Database
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
1) Better display for assignments: 
A new icon for questionnaires added 
[[File:new_icon_view.png|center|frame]] 
On click of icon it will display questionnaires related to the selected course 
[[File:questionnaires_view.png|center|frame]] 
2) Dashboard for students: 
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

=Steps to check the new implementations=

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T04:37:04Z

Vjsangha: /* Functionality of each file */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
questionnaire_type_node.rb
<li>
View
</li>
grades\view_my_scored.html.erb, tree_display/actions/_courses_actions.html.erb, tree_display/_page_header.html.erb
<li>
Controller
</li>
grades_controller.rb, questionnaires_controller.rb, tree_display_controller.rb
<li>
Database
</li>
db/schema.rb
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> questionnaire_type_node.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display/_page_header.html.erb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 5 '''''
| <code> grades_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 6 '''''
| <code> grades_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 7 '''''
| <code> questionnaires_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 8 '''''
| <code> tree_display_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 9 '''''
| <code> schema.rb </code>
| Database
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
1) Better display for assignments: 
A new icon for questionnaires added 
[[File:new_icon_view.png|center|frame]] 
On click of icon it will display questionnaires related to the selected course 
[[File:questionnaires_view.png|center|frame]] 
2) Dashboard for students: 
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

=Steps to check the new implementations=

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T04:36:23Z

Vjsangha: /* Functionality of each file */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
questionnaire_type_node.rb
<li>
View
</li>
grades\view_my_scored.html.erb, tree_display/actions/_courses_actions.html.erb, tree_display/_page_header.html.erb
<li>
Controller
</li>
grades_controller.rb, questionnaires_controller.rb, tree_display_controller.rb
<li>
Database
</li>
db/schema.rb
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> questionnaire_type_node.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display/_page_header.html.erb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 5 '''''
| <code> grades_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 6 '''''
| <code> grades_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 7 '''''
| <code> questionnaires_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 8 '''''
| <code> tree_display_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 9 '''''
| <code> schema.rb </code>
| Database
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
1) Better display for assignments: 
A new icon for questionnaires added 
[[File:new_icon_view.png|center|frame]] 
On click of icon it will display questionnaires related to the selected course 
[[File:questionnaires_view.png|center|frame]] 
2) Dashboard for students: 
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

=Steps to check the new implementations=

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T04:16:36Z

Vjsangha: /* Files to be merged : Dashboard for students */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
questionnaire_type_node.rb
<li>
View
</li>
grades\view_my_scored.html.erb, tree_display/actions/_courses_actions.html.erb, tree_display/_page_header.html.erb
<li>
Controller
</li>
grades_controller.rb, questionnaires_controller.rb, tree_display_controller.rb
<li>
Database
</li>
db/schema.rb
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
1) Better display for assignments: 
A new icon for questionnaires added 
[[File:new_icon_view.png|center|frame]] 
On click of icon it will display questionnaires related to the selected course 
[[File:questionnaires_view.png|center|frame]] 
2) Dashboard for students: 
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T04:16:24Z

Vjsangha: /* Files to be merged : Dashboard for students */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
questionnaire_type_node.rb
<li>
View
</li>
grades\view_my_scored.html.erb, tree_display/actions/_courses_actions.html.erb, tree_display/_page_header.html.erb
<li>
Controller
</li>
grades_controller.rb, questionnaires_controller.rb, tree_display_controller.rb
<li>
Database Changes
</li>
db/schema.rb
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
1) Better display for assignments: 
A new icon for questionnaires added 
[[File:new_icon_view.png|center|frame]] 
On click of icon it will display questionnaires related to the selected course 
[[File:questionnaires_view.png|center|frame]] 
2) Dashboard for students: 
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T04:15:58Z

Vjsangha: /* Files to be merged : Dashboard for students */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
questionnaire_type_node.rb
<li>
View
</li>
grades\view_my_scored.html.erb, tree_display/actions/_courses_actions.html.erb, tree_display/_page_header.html.erb
<li>
Controller
</li>
grades_controller.rb, questionnaires_controller.rb, tree_display_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
1) Better display for assignments: 
A new icon for questionnaires added 
[[File:new_icon_view.png|center|frame]] 
On click of icon it will display questionnaires related to the selected course 
[[File:questionnaires_view.png|center|frame]] 
2) Dashboard for students: 
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T04:15:23Z

Vjsangha: /* Files to be merged : Dashboard for students */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
questionnaire_type_node.rb
<li>
View
</li>
grades\view_my_scored.html.erb, tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
grades_controller.rb, questionnaires_controller.rb, tree_display_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
1) Better display for assignments: 
A new icon for questionnaires added 
[[File:new_icon_view.png|center|frame]] 
On click of icon it will display questionnaires related to the selected course 
[[File:questionnaires_view.png|center|frame]] 
2) Dashboard for students: 
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T04:14:55Z

Vjsangha: /* Files to be merged : Dashboard for students */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
questionnaire_type_node.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, questionnaires_controller.rb, tree_display_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
1) Better display for assignments: 
A new icon for questionnaires added 
[[File:new_icon_view.png|center|frame]] 
On click of icon it will display questionnaires related to the selected course 
[[File:questionnaires_view.png|center|frame]] 
2) Dashboard for students: 
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T04:14:06Z

Vjsangha: /* Files to be merged : Dashboard for students */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
questionnaire_type_node.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
1) Better display for assignments: 
A new icon for questionnaires added 
[[File:new_icon_view.png|center|frame]] 
On click of icon it will display questionnaires related to the selected course 
[[File:questionnaires_view.png|center|frame]] 
2) Dashboard for students: 
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T04:12:15Z

Vjsangha: /* Screenshots */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
1) Better display for assignments: 
A new icon for questionnaires added 
[[File:new_icon_view.png|center|frame]] 
On click of icon it will display questionnaires related to the selected course 
[[File:questionnaires_view.png|center|frame]] 
2) Dashboard for students: 
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T04:10:36Z

Vjsangha: /* Screenshots */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
1) Better display for assignments: 
A new icon for questionnaires added 
[[File:new_icon_view.png]] 
On click of icon it will display questionnaires related to the selected course 
[[File:questionnaires_view.png]] 
2) Dashboard for students: 
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T04:09:59Z

Vjsangha: /* Screenshots */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
Better display for assignments: 
A new icon for questionnaires added 
[[File:new_icon_view.png]] 
On click of icon it will display questionnaires related to the selected course 
[[File:questionnaires_view.png]] 
Dashboard for students: 
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T04:09:24Z

Vjsangha: /* Screenshots */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
Better display for assignments: 
A new icon for questionnaires added 
[[File:new_icon_view.png]] 
On click of icon it will display questionnaires related to the selected course 
[[File:questionnaires_view.png]] 
Dashboard for students: 
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

File:Questionnaires view.png

2014-12-04T04:08:54Z

Vjsangha:

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T04:08:25Z

Vjsangha: /* Screenshots */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
Better display for assignments: 
A new icon for questionnaires added 
[[File:new_icon_view.png]] 
On click of icon it will display questionnaires related to the selected course 
[[File:questionnaires_view.png|frame|left| ]] 
Dashboard for students: 
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T04:08:01Z

Vjsangha: /* Screenshots */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
Better display for assignments: 
A new icon for questionnaires added 
[[File:new_icon_view.png|frame]] 
On click of icon it will display questionnaires related to the selected course 
[[File:questionnaires_view.png|frame|left| ]] 
Dashboard for students: 
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

File:New icon view.png

2014-12-04T04:07:26Z

Vjsangha:

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T04:06:53Z

Vjsangha: /* Screenshots */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
Better display for assignments: 
A new icon for questionnaires added 
[[File:new_icon_view.png|frame|left| ]] 
On click of icon it will display questionnaires related to the selected course 
[[File:questionnaires_view.png|frame|left| ]] 
Dashboard for students: 
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T04:05:02Z

Vjsangha: /* Screenshots */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
Better display for assignments: 
A new icon for questionnaires added
[[File:new_icon_view.png|frame|left| ]]
On click of icon it will display questionnaires related to the selected course
[[File:questionnaires_view.png|frame|left| ]]
Dashboard for students: 
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T03:58:38Z

Vjsangha: /* Screenshots */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
Better display for assignments: 
Dashboard for students: 
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T03:58:06Z

Vjsangha: /* Screenshots */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =

Dashboard for students 
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T03:57:44Z

Vjsangha: /* Screenshots */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =

Dashboard for students
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T03:50:28Z

Vjsangha: /* Screenshots */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
It shows the different between previous implementation and new implementation views.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

File:After view.png

2014-12-04T03:48:04Z

Vjsangha: uploaded a new version of "File:After view.png"

File:Before view.png

2014-12-04T03:47:34Z

Vjsangha: uploaded a new version of "File:Before view.png"

File:After view.png

2014-12-04T03:42:26Z

Vjsangha: uploaded a new version of "File:After view.png"

File:Before view.png

2014-12-04T03:41:43Z

Vjsangha: uploaded a new version of "File:Before view.png"

File:After view.png

2014-12-04T03:37:01Z

Vjsangha:

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T03:36:42Z

Vjsangha: /* Screenshots */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
It shows the different between previous implementation and new implementation.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after_view.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T03:36:24Z

Vjsangha: /* Screenshots */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
It shows the different between previous implementation and new implementation.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.png|frame|left| ]]
| [[File:after.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

File:Before view.png

2014-12-04T03:35:48Z

Vjsangha:

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T03:34:44Z

Vjsangha: /* Screenshots */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
It shows the different between previous implementation and new implementation.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before_view.jpg|frame|left| ]]
| [[File:after.jpg|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T03:34:03Z

Vjsangha: /* Screenshots */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
It shows the different between previous implementation and new implementation.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:before.jpg|frame|left| ]]
| [[File:after.jpg|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T03:33:06Z

Vjsangha: /* Screenshots */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
It shows the different between previous implementation and new implementation.

{| class="wikitable"
|-
! Before
! After

|-
| [before.png|frame|left| ]]
| [after.png|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T03:32:16Z

Vjsangha: /* Screenshots */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
It shows the different between previous implementation and new implementation.

{| class="wikitable"
|-
! Before
! After

|-
| [|frame|left| ]]
| [[frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T02:58:40Z

Vjsangha: /* Screenshots */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
It shows the different between previous implementation and new implementation.

{| class="wikitable"
|-
! Before
! After

|-
| [[File:Refactored_Leaderboard_file.jpg|frame|left| ]]
| [[File:Non_Refactored_Leaderboard_file.jpg|frame|left| ]]

|-
| [[File:Refactored_personal_achievement_file.jpg|frame|left| ]]
| [[File:Non_personal_achievement_file.jpg|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T02:58:05Z

Vjsangha: /* Screenshots */

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =
It shows the different between previous implementation and new implementation.

{| class="wikitable"
|-
! View of Refactored Leaderboard
! View of Original Leaderboard

|-
| [[File:Refactored_Leaderboard_file.jpg|frame|left| ]]
| [[File:Non_Refactored_Leaderboard_file.jpg|frame|left| ]]

|-
| [[File:Refactored_personal_achievement_file.jpg|frame|left| ]]
| [[File:Non_personal_achievement_file.jpg|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T02:56:59Z

Vjsangha:

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Screenshots =

{| class="wikitable"
|-
! View of Refactored Leaderboard
! View of Original Leaderboard

|-
| [[File:Refactored_Leaderboard_file.jpg|frame|left| ]]
| [[File:Non_Refactored_Leaderboard_file.jpg|frame|left| ]]

|-
| [[File:Refactored_personal_achievement_file.jpg|frame|left| ]]
| [[File:Non_personal_achievement_file.jpg|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-12-04T02:56:33Z

Vjsangha:

=Expertiza - Information Display and Student Interaction=

[My main comment is that I would like a mockup of how your screens are going to look, so I can judge if the required info is there and if the UI is intuitive enough.]
Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and its codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

= Changes =

{| class="wikitable"
|-
! View of Refactored Leaderboard
! View of Original Leaderboard

|-
| [[File:Refactored_Leaderboard_file.jpg|frame|left| ]]
| [[File:Non_Refactored_Leaderboard_file.jpg|frame|left| ]]

|-
| [[File:Refactored_personal_achievement_file.jpg|frame|left| ]]
| [[File:Non_personal_achievement_file.jpg|frame|left| ]]

|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
Following is class diagram for Assignment display module. <ref>Previous year's design document for ''E707: Better display for assignments'' by Bharath Sampath(bsampat2),Prakash Vasudevan(pvasude),Raghavendran Nedunchezhian(rnedunc), Yuchuan Liu(yliu63)</ref>

[[File:UML.jpg]]

Following is class diagram for Dashboard for students module.

[[File:Dashboard.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-11-12T04:02:06Z

Vjsangha: /* Functionality of each file */

=Expertiza - Information Display and Student Interaction=

Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and it's codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
[[File:UML.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-11-12T04:01:52Z

Vjsangha: /* Functionality of each file */

=Expertiza - Information Display and Student Interaction=

Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and it's codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality involved for implementation
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality for this project
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
[[File:UML.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-11-12T04:00:45Z

Vjsangha: /* Functionality of each file */

=Expertiza - Information Display and Student Interaction=

Expertiza is a web application developed using Ruby on Rails that serves as a peer-review system. The application allows students to submit and peer-review learning objects (articles, code, web sites, etc)<ref>[https://github.com/expertiza/expertiza Expertiza on GitHub]</ref><ref>[http://wikis.lib.ncsu.edu/index.php/Expertiza Expertiza Wiki Page]</ref>. It is an open source project and it's codebase is maintained in GitHub.

__TOC__

=Introduction=
Our contribution in this project would be to improve the display of questionnaires for all the instructors and also integrating a previous project which provides a new dashboard for students to view and compare their performance of each assignment.

==Current State==
*In the current state instructor should go through all the questionnaires to find the one they are looking for.
*The keyword search functionality is not yet implemented for questionnaires.
*The current student dashboard provides the average score and range of the student’s assignment, review and final score.
*The system has a limitation where in a student/instructor cannot view and compare the student scores based on the class performance.

==Goals==
*As a part of our project we will implement the search functionality and also make it possible to click and bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires.
*A project from last year has the implementation for the new student dashboard. We would like to take that project, make the required changes to it and integrate it into expertiza.
*This new dashboard gives the students a comparative statistics for that particular assignment for the entire class.
*Giving the min, mean and max gives the student a range to judge where they stand with respect to the class.
*Other features were part of the project were to show the number of reviews and metareviews he/she has done for this assignment and also based on a threshold what are the number of reviews/metareviews the student still needs to do.
*A histogram distribution of the scores of the class (all teams) for that assignment would also shown as a part of the dashboard.

=Approach=

As the project was originally assigned to students two years ago, the functionality is mostly complete. The main concern is that, as the project was completed a significant amount of time ago (in December 2012), it was made for an older version of rails.

==General Approach==
Our general approach to the project would be as follows:
*Run the current project with rails 4
*Check the functionality to find out the incompatible and missing parts
*Refactor the parts of code that do not function as expected and port them to rails 4 specification
*After making sure everything runs, refactor the entire code to make sure it follows the global code rules.

==Specific Approach==
The specific approach to each of the two functionality is as follows:
===Better display for assignments===

We found that while the currently existing code covers most of the functionality, a major part of the functionality is missing. According to definition, the instructor should see the following on his home page:
*The instructor's courses
*Assignments for those courses
*Questionnaire by assignment name

Each of these should be compressed to titles only, and it should be possible to expand them by single mouse click. Each course should have its own list of assignments which can, again, be expanded. Also, there is a search box on the page which allows to search assignments, courses and questionnaires.

The search functionality for assignments and courses is working well, but the search for questionnaires is not implemented.

So, for this specific project, we plan to focus on implementing the search for questionnaires first. Then, integrate it all and test each functionality: make sure that nothing is affected by the new functionality added. After all the tests are performed, we will merge the project with the main project, thus integrating it with the final build.

===Dashboard for students===

The features required for the dashboard for students project have already been implemented. So, the main task to be performed by us is to merge the project files with the main project and make sure that nothing else is affected by the process.

The current code is able to display the maximum scores, average scores, number of reviews and distribution charts.

=Files involved=
===Files to be merged : Dashboard for students===
<ul>
<li>
Model
</li>
ScoreCache.rb
<li>
View
</li>
grades\view_my_scored.html.erb
<li>
Controller
</li>
grades_controller.rb, review_mapping_controller.rb,response_controller.rb
<li>
Database tables
</li>
Assignments,Participants, score_caches, response_maps,responses
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality for this project
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> ScoreCache.rb </code>
| Model
| Makes an entry into score_cache table whenever a response is given/edited
|-
|style="text-align:center;"|''''' 2 '''''
| <code> grades\view_my_scores.html.erb </code>
| View
| Modified in order to display all new features
|-
|style="text-align:center;"|''''' 3 '''''
| <code> grades_controller.rb </code>
| Controller
| To get information all information about an assignment and its score which is average score of all reviews and plotting the graph for grade distinction
|-
|style="text-align:center;"|''''' 4 '''''
| <code> review_mapping_controller.rb </code>
| Controller
| To get additional information about assignment like total reviews submitted
|-
|style="text-align:center;"|''''' 5 '''''
| <code> Assignments </code>
| Table
| All information related to assignment
|-
|style="text-align:center;"|''''' 6 '''''
| <code> Responses </code>
| Table
| Stores individual assignment review response information
|-
|style="text-align:center;"|''''' 7 '''''
| <code> Score_caches </code>
| Table
| Stores individual assignment review score information
|-
|style="text-align:center;"|''''' 8 '''''
| <code> response_maps </code>
| Table
| Mapping between response, reviewer and reviewee
|}

===Files to be changed : Better display of assignment===
<ul>
<li>
Model
</li>
course_node.rb,assignment_node.rb,questionnaire_node.rb
<li>
View
</li>
tree_display\ _row_header.html.erb,tree_display\ _entry.html.erb,tree_display/actions/_courses_actions.html.erb
<li>
Controller
</li>
tree_display controller.rb,course_controller.rb,assignment_controller.rb,questionnaire_controller.rb
<li>
JavaScript
</li>
tableactions.js
</ul>

====Functionality of each file====

{| class="wikitable"
|-
! style="width:2%;"|Sr. No.
! style="width:8%;"|File Name
!style="width:13%;"| Type
! style="width:43%;"|Functionality for this project
|- style="vertical-align:top;"
|-
|style="text-align:center;"|''''' 1 '''''
| <code> course_node.rb </code>
| Model
| To fetch information about all course none in the system
|-
|style="text-align:center;"|''''' 2 '''''
| <code> assignment_node.rb </code>
| Model
| To fetch information about all assignment node in the system
|-
|style="text-align:center;"|''''' 3 '''''
| <code> questionnaire_node.rb </code>
| Model
| To fetch information about all questionnaire node in the system
|-
|style="text-align:center;"|''''' 4 '''''
| <code> tree_display\ _row_header.html.erb </code>
| View
| Display of header in a row
|-
|style="text-align:center;"|''''' 5 '''''
| <code> tree_display\ _entry.html.erb </code>
| View
| Display entity in a row
|-
|style="text-align:center;"|''''' 6 '''''
| <code> tree_display/actions/_courses_actions.html.erb </code>
| View
| Display separate actions on each row
|-
|style="text-align:center;"|''''' 7 '''''
| <code> course_controller.rb </code>
| Controller
| Provides various course related functions
|-
|style="text-align:center;"|''''' 8 '''''
| <code> assignment_controller.rb </code>
| Controller
| Provides various assignment related functions
|-
|style="text-align:center;"|''''' 9 '''''
| <code> questionnaire_controller.rb </code>
| Controller
| Provides various questionnaire related functions
|-
|style="text-align:center;"|''''' 10 '''''
| <code> tree_display controller.rb </code>
| Controller
| For direct access to every entity like questionnaires, review rubric etc..
|}

=Use case=
For the instructor, there needs to be a way to quickly find rubrics (and other questionnaires) that have been used in a single course. It should be possible to search or click somewhere to bring up a list of questionnaires used in the course, expanding only the applicable questionnaires in the list of questionnaires. A search functionality for questionnaire is expected. Currently, assignment and course searches is implemented, and there is a dropdown for questionnaire, but it's functionality is missing.

'''Actor:''' Instructot

'''Other Participants:''' None

'''Precondition:''' There are few questionnaires in the system

'''Primary Sequence:'''

1. Log in to Expertiza

2. Instructor lands on "Manage content" page

3. Search for a questionnaire, by selecting questionnaire in the search dropdown and input some search string

4. Search results displayed, expanding only the applicable questionnaires in the list of questionnaires

[[File:Assignment_display_existing.jpg]]

The following use case diagram shows the system of Assignment grades for a student on Expertiza as it is depicted right now. These include viewing their own project submission (with url and attachments), reviews and metareviews on their work, author feedbacks, teammate reviews and their final score on that assignment/project.<ref>Previous year's design document for ''E715: Dashboard for Students'' by Ambika Tripathi, Milan Tonse, Krutika Nagar, Shruti Buch</ref> As part of this project we shall be adding more data on this page, so that student has better understanding of his/her marks.

'''Name''': Students viewing scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the average, high and low class score for that particular assignment

'''Name''': Students viewing graphical output for scores for the assignment

'''Actor''': Student

'''Other Participants''': None

'''Precondition''': Statistics have been recorded for average high and low scores.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class scores for this assignment.

5. View the graphical output for average, high and low class score for that particular assignment

'''Name''': Students viewing number of reviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of reviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my reviews for this assignment.

5. View the number of reviews the student has done for that particular assignment and also the

number of reviews he still has to do to reach the threshold.

'''Name''': Students viewing number of metareviews done by him/her

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for number of metareviews done by the student.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for my metareviews for this assignment.

5. View the number of metareviews the student has done for that particular assignment and also

the number of metareviews he still has to do to reach the threshold.

'''Name''': Students viewing average number of class reviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class reviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class reviews for this assignment.

5. View the average number of class reviews for that particular assignment

'''Name''': Students viewing average number of class metareviews for the assignment

'''Actor''': Student

'''Other Participants:''' None

'''Precondition''': Statistics have been recorded for class metareviews for that assignment.

'''Primary Sequence:'''

1. Log in to Expertiza

2. Select an assignment

3. Select Your Scores

4. Click on the link for view class metareviews for this assignment.

5. View the average number of class metareviews for that particular assignment

[[File:Dashboard_existing.jpg]]

[[File:Dashboard_new.jpg]]
=UML diagram=
[[File:UML.jpg]]

='''References'''=
<references/>

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-11-12T03:21:43Z

Vjsangha: /* Files to be merged : Dashboard for students */

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-11-12T03:21:24Z

Vjsangha: /* Files to be merged : Dashboard for students */

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-11-12T03:19:04Z

Vjsangha: /* Functionality of each file */

CSC/ECE 517 Fall 2014/final E1471 asuv

2014-11-12T03:18:45Z

Vjsangha: /* Functionality of each file */