[PATCH] A Classroom

[arafaysaleem]

Summary

As an admin, I should be able to update the details of a classroom, so that I can fix old or inconsistent entries.

Acceptance Criteria

GIVEN an admin is editing a classroom in the app
WHEN the app hits the /classrooms/:id endpoint with a valid PATCH request, containing:-
The path parameter:

• :id, the unique id of the entity of which the details are edited.

And any of the following body parameters:

• classroom
• campus_id

THEN the app should receive a status 200
AND in the response, the following information should be returned:

• header message indicating update operation success
• rows matched
• rows changed

Sample Request/Sample Response

headers: {
    error: 0,
    message: "The specified item was updated successfully"
}
body: {
    rows_matched: 1,
    rows_changed: 1,
    info: "..."
}

Resources

• Development URL: {Here goes a URL to the feature on development API}
• Production URL: {Here goes a URL to the feature on production API}

Dev Notes

{Some complementary notes if necessary}

Testing Notes

Scenario 1: PATCH request is successful

1. Update a classroom with a PATCH request to /classrooms/:id endpoint
2. A subsequent GET request to /classrooms/:id endpoint should return a status code 200
3. And the classroom details with the updated information i.e. matching the initially sent body.
4. Resubmit a PATCH request to /classrooms/:id endpoint to reverse the change and ensure status code 200 is returned.

Scenario 2: PATCH request is unsuccessful due to unknown classroom_id

1. Update a classroom with a PATCH request to /classrooms/:id endpoint containing a non-existent classroom_id.
2. Ensure a 404 status code is returned.
3. And the response headers' code parameter should contain "NotFoundException".

Scenario 3: PATCH request is unsuccessful due to unknown campus_id

1. Update a classroom with a PATCH request to /classrooms/:id endpoint containing a non-existent campus_id.
2. Ensure a 422 status code is returned.
3. And the response headers' code parameter should contain "ForeignKeyViolationException".

Scenario 4: PATCH request is incorrect

1. Send a PATCH request to /classrooms/:id endpoint with an incorrect key name in the body
2. Ensure a 422 status code is returned
3. And the response headers' code parameter should contain "InvalidPropertiesException".
4. And the response headers' data parameter should contain the name of the invalid parameter.

Scenario 5: PATCH request is forbidden

1. Send a PATCH request to /classrooms/:id endpoint using a student account token.
2. Ensure the response returns a 403 forbidden status code.
3. And the response headers' code parameter should contain "ForbiddenException"

Scenario 6: PATCH request is unauthorized

1. Send a PATCH request to /classrooms/:id endpoint without an authorization token
2. Ensure a 401 unauthorized status code is returned.
3. And the response headers' code parameter should contain "TokenMissingException"