As a contractor, I should be able to create milestone stages, so that I can assign persons to it and dictate the quality of work done during a milestone

[arafaysaleem]

Summary

As a contractor, I should be able to create milestone stages, so that I can assign persons to it and dictate the quality of work done during a milestone.

Acceptance Criteria

GIVEN an contractor is creating a milestone stage in the desktop app
WHEN the app hits the /milestone-stages endpoint with a valid POST request, containing:

• criteria
• review_date
• is_approved
• completion_percentage
• milestone_id
• project_role_id

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

• headers
• stage details

Sample Request/Sample Response

headers: {
    error: 0,
    message: "..."
}
body: {
    "stage_id": 0,
    "affected_rows": 1
}

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: POST request is successful

1. Create a new milestone stage with a POST request to /milestone-stages endpoint and ensure a 201 status code is returned.
2. Use the id returned by the response in a subsequent GET request to /milestone-stages/:id endpoint and ensure a 200 status code is returned.
3. Ensure the response contains a milestone stage with the correct information i.e. matching the initially sent body.

Scenario 2: POST request is incorrect

1. Send a POST request to /milestone-stages endpoint with the body containing an incorrect key.
2. Ensure a 422 status code is returned
3. And the response headers' code parameter should contain an error pointing out failed validation.

Scenario 3: POST request is forbidden

1. Send a POST request to /milestone-stages endpoint with a inspector account token.
2. Ensure a 403 forbidden status code is returned.
3. And the response headers' code parameter should contain an error pointing out failed access.