Specification

Purpose

This WS  is design to update flags "is_active" for Medical Program.

WS logic

Authorize

1. Verify the validity of access token
   1. In case error - generate 401 response
2. Check user scope (scope = 'medical_program:deactivate') in order to perform this action
   1. In case error - generate 403 response

Validate FKs

Purpose validation: Check on active program medication. Only medical program without active program medication can be deactivated. In case on existing active program medication linked with medical program error must be shown.

1. Check exist `program_medication` by $.medical_program_id=$.id & `is_active`= false 
   1. if invalid - return 409 error (message: "This program has active participants. Only medical programs without participants can be deactivated.")

Validate PK Program Medications

Purpose validation: Check on existing record for Medical program

1. Check exist `Medical_program` by $.id.

   1. if invalid - return 404 error (message: "Medical program with id={$.id} doesn't exist.")

Validate status

Purpose validation:  Medical program should be active (is_active == TRUE) 

1. Validate `is_active` == TRUE

1. 1. if invalid  - return 409 error (message: "Medical program is not active and can't be deactivated")

Deactivate Program Medications

Update medical program record by $.id  set values:

Prepare & return response data structure

1. Fill response WS data structure 
2. Validate response using JSON schemas (!!! TBD)
   1. Return 422 with list of validation errors in case validation fails (422 EView)