zanna-37 / se2-herokusiffredi Goto Github PK

a would put submissionId instead of subId to be more clear
Should also be change in the "REST endpoints.md"

As a professor I want to assign a list of tasks to a set of users or groups so that they can solve it.

How to demo:
Send a POST request to /exams/{id}/participants with these values:

• the ids of the participants
• the id of the exam
• the ids of the tasks

Effort: 3

As a professor I want to modify the name of a task category

How to demo:
return a result for a success or an error

Effort: 0.5

As a professor, I want to update all my exams in a course.

How to demo:
Send a PUT request to /exams with a list of exam objects.
An exam object contains these fields:

• id
• examTemplateId
• ownersIds[ ]
• (avg mark)
• defaultDeadline
  • start
  • end

You will get a response with code 204.

Effort: 2

As a professor I want to delete a category

How to demo:
Delete a list of task-category ids and return a error whether they was successfully deleted or not

Effort: 1

As a professor, I want to decide which type of tasks will appear in the exam and also their quantities

How to demo:
send a POST request to /exam-templates with these values:

• name of the template
• the category Ids
• quantities

Effort: 1

As a participant, I want to read my mark and comment of a submission

How to do:
send a GET request to /exams/{id}/participants/{id}

**Effort: ** 1

As a professor, I want to be able to get the list of all users.

How to demo:
send a GET request to /users. You will get a json object with these attributes:

• id
• studentNumber
• name
• surname
• average

Effort: 1

As a professor, I want to be able to read a specific exam template, so that I can read it

How to demo:
send a GET request to /exam-templates/{id}
The response should be a json with these attribute:

• id
• name
• categoryId[ ]
• quantity[ ]

Effort: 1

As a student, I want to change a specific template, so i can use it

How to do:
Send a PUT request to /exam-templates/{id} with these attribute:

• id
• name
• categoryIds[ ]
• quantity[ ]

You will get a response with code 204

Effort: 2

As a participant, I want to be able to submit again my answer, so that the teacher has the latest version

How to demo:
After sending all the fields needed ( #59 ) an error code is returned depending on the result of the transaction

Effort: 2

As a user I want to retrieve a specific task that has been assigned in a way that when the main task is modified this will remember the previous state of when it was assigned.
This assigned task must not be modified in any ways and serves for legal proof

HOW TO DEMO:
The result should be a json containing the same fields as a task

Effort: 0.5

As a professor, I want to define an exam with a specific template and a deadline.

How to demo:
Post on /exam

Effort: 3

As a professor, I want to be able to delete a task

How to demo:
send a DELETE request to /tasks/{id}

The response should be a success message

Effort: 1

As a professor, I want to be able to get all existent exams.

How to demo:
Send a GET requesto to /exams. You will get a json object with these attributes inside:

• id
• examTemplateId
• ownersIds[ ]
• (avg mark)
• defaultDeadline
  • start
  • end

**Effort: ** 1

As a professor, I want to be able to delete a list of tasks

How to demo:
send a DELETE request to /tasks with a list of tasks id

The response should be a success message

Effort: 1

as a professor I want to delete a previously created task-category

How to demo:
return a code for success or error

Effort: 0.5

As a user I want to review my submission for the task, filtered for exam, user and/or task

How to demo:
return a list of submissions #59

Effort: 0.5

As a professor, I should be able to delete a list of courses at the same time.

How to demo:
send a DELETE request to /courses with the list of course objects you wish to delete.
The response should be a success message.

Effort: 0.5

As a user I want to review a previously submitted answer

How to demo:
After a specific submissionId is requested, a json object containing the following is returned:

• examId
• submissionId
• userId
• assignedTaskId
• userAnswer
• finalCorrectionId

Effort: 2

As a professor, I want to delete a specific exam template

How to do:
Send a DELETE request to /exam-template/{id}

You will get a response with code 204.

Effort: 2

As a professor, I want to be able to create a course, so that students can enroll.

How to demo:
Send a POST request to /courses with these attributes:

• name
• academic year

Effort: 0.5

As a user i want to retrieve a task category to get its name

How to demo:
after have specified an id return a json with

• id
• name

Effort: 0.5

As a professor, I want to give a final evaluation of a specific task

How to demo:
send a PATCH request to /exams/{id}/task-submissions with this values:

• subId
• finalCorrectionId

Effort: 1

As a student, I want to retrieve the user that represent myself in the system.

How to demo:
Send a GET request to /user/{id}, where {id} is your identifier.
You will get a response with these attributes in the body:

• id
• studentNumber
• name
• surname
• average

Effort: 1

As a professor, I want to be able to get information on a specific course.

How to demo:
send a GET request to /courses/{id}
The response should be a json with these attributes:

• id
• name
• academic year

Effort: 0.5

As a professor, I want to be able to change a list of exams template, so that I can use it

How to demo:
send a PUT request to /exam-templates with a list of exam template containing these attribute:

• id
• name
• categoryId[ ]
• quantity[ ]

The response should be a success message
Effort: 1

As a student, I want to modify my specific information (like name, surname, email, ...).

How to do:
Send a PUT request to /users/{id}, where {id} is your id, and specify all the fields (also the not changed ones):

• studentNumber
• name
• surname

You will get a response with code 204.

Effort: 2

As a professor, I want to update multiple users at the same time.

How to demo:
Send a PUT request to /users with a list of user objects.
A user object contains these fields:

• id
• studentNumber
• name
• surname

You will get a response with code 204.

Effort: 2

As a professor, I want to be able to delete an exam template

How to demo:
send a DELETE request to /exam-templates specifing the list of exam template to delete

The response should be a success message
Effort: 2

As a professor, I want to be able to get all tasks, so that I can read it

How to demo:
send a Get request to /tasks:

The response should be a json with a list of tasks containing these attributes:

• id
• exerciseText
• answers[ ]
  • answer
  • isRight
• spiegazione
• categoryId
• punteggio tot
• ultima modifica

Effort: 1

As a professor I want to create category to categories task so that can be added to exam templates by category

How to demo:
Create a category giving it a name

Effort: 0.5

As a professor, I want to be able to read al single task, so that I read it

How to demo:
send a GET request to /tasks/{id}

The response should be a json with these attributes:

• id
• exerciseText
• answers[ ]
  • answer
  • isRight
• explantaion
• categoryId[ ]
• total score
• last edit

Effort: 1

As a professor I want to modify a list of categories

How to demo:
after supply a list of category to be modified return a code whether all the modifies was successful or not

Effort: 1

As a professor, I want to be able to read all the exams template, so that I can read it

How to demo:
send a GET request to /exam-templates:
The response should be a json with these attributes:

• id
• name
• categoryId[ ]
• quantity[ ]

Effort: 1

Users can have more than one group so why is group id an attribute of user?

Row: 555
file: swagger.yaml
commit: fab2867

As a student I want to create a submission for a specific task in a specific exam

How to demo:
a submission should be created when passing these fields, and an error code for the result of the transaction

• examId
• subId
• userId
• assignedTaskId
• userAnswer

Effort: 3

As a participant, I want to be able to send my correction proposal of a user's submission

How to demo:
send a POST request to /exams/{id}/task-corrections with these values:

• submission id
• mark
• comment
• the id of the proposer

**Effort: **2

As a professor, I want to be able to create an exam template, so that I can use it

How to demo:
send a POST request to /exam-templates with these attribute:

• name
• categoryId[ ]
• quantity[ ]
  The response should be success message

Effort: 1

As a student, I want to be able to create my account, so that I can access the system

How to demo:
send a POST request to /users with these values:

• the student number
• name
• surname

Effort: 1

As a professor, I want to delete a specific list of exams.

How to demo:
Send a DELETE requesto to /exams with a list of exams' ids.
You will get a response with code 204.

Effort: 2

As a professor, I want to delete a list of users.

How to demo:
Send a DELETE request to /users with a list of users' ids.
You will retrive a response with code 204.

Effort: 3

As a professor, I want to be able to create an exam and also set other owners, so that they can edit the exam too.

How to demo:
send a POST request to /exams with these values:

• the id of the exam template to which this exam belongs
• the list of the owners ids
• the default deadline

**Effort: **3

As a professor I want to retrieve all the categories so I can assign task to them

How to demo:
return a json with the field in task-category #33

Effort: 1

As a student, I want to delete myself from the system when I finish the university.

How to demo:
Send a DELETE request to /users/{id}, where {id} is your id.
You will get a response with a code 204.

Effort: 2

As a professor, I want to be able to change a list of tasks, so that I can use it

How to demo:
send a PUT request to /tasks with a list of tasks containing:

• id
• exerciseText
• answers[ ]
  • answer
  • isRight
• explantaion
• categoryId[ ]
• total score
• last edit

The response should be a success message

Effort: 1

As a student, I want to be able to get all courses.

How to demo:
Send a GET request to /courses
The response should be a json with a list of courses that have these attributes:

• id
• name
• academic year

Effort: 1

As a professor, I want to create reusable tasks that I can put in exams.

How to demo:
Post on /tasks with these values:

• the text of the exercise
• a list of answer and the correct choice
• a category of the task
• total score
• explanation
• last edit

Effort: 1

As a professor, I want to be able to update a list of courses at the same time in the same request.

How to demo:
send a PUT request to /courses with a list of course objects.
Those objects should have these fields:

• id
• name
• academic year

Effort: 1

As a professor, I want to be able to change a task, so that I can use it

How to demo:
send a PUT request to /tasks/{id} with these attribute:

• id
• exerciseText
• answers[ ]
  • answer
  • isRight
• explantaion
• categoryId[]
• total score
• last edit

The response should be a success message

Effort: 1