RC_(GraphQL) Get DRACS Divorce Act details (DRACS 2.0)

1 Purpose
2 Key points
3 Specification
4 Authorize
5 Validate legal entity
6 Validate request
- 6.1 Validate $.id
7 Service logic

Purpose

This WS is designed to allow NHS employee with assigned appropriate scopes to get DRACS Divorce Act details.

Key points

This is a graphQl query method used in Administration panel only.
Only authenticated and authorized NHS employee with appropriate scope can get DRACS Divorce Act details.

Specification

  "Reads a single `DracsDivorceAct` using its globally unique ID."
  dracsDivorceAct(id: ID!): DracsDivorceAct

type DracsDivorceAct implements Node {
  id: ID!
  databaseId: UUID!
  arRegDate: Date
  arRegNumber: String
  opDate: Date
  arOpName: String
  regNumb: String
  composeDate: String
  composeOrg: String
  isRestore: Int
  mnOldSurname: String
  mnSurname: String
  mnName: String
  mnPatronymic: String
  mnNumident: String
  mnDateBirth: String
  mnCitizenship: Int
  mnCitizenshipAnother: String
  mnDocType: String
  mnDocName: String
  mnSeriesNumb: String
  mnDocDate: String
  mnDocOrgName: String
  mnBirthState: String
  mnBirthRegion: String
  mnBirthDistrict: String
  mnBirthLocalityType: String
  mnBirthLocality: String
  mnState: String
  mnRegion: String
  mnDistrict: String
  mnLocalityType: String
  mnLocality: String
  mnStreet: String
  mnHouse: String
  mnBuildingPart: String
  mnBuildingPartType: String
  mnApartment: String
  wmnOldSurname: String
  wmnSurname: String
  wmnName: String
  wmnPatronymic: String
  wmnNumident: String
  wmnDateBirth: String
  wmnCitizenship: Int
  wmnCitizenshipAnother: String
  wmnDocType: String
  wmnDocName: String
  wmnSeriesNumb: String
  wmnDocDate: String
  wmnDocOrgName: String
  wmnBirthState: String
  wmnBirthRegion: String
  wmnBirthDistrict: String
  wmnBirthLocalityType: String
  wmnBirthLocality: String
  wmnState: String
  wmnRegion: String
  wmnDistrict: String
  wmnLocalityType: String
  wmnLocality: String
  wmnStreet: String
  wmnHouse: String
  wmnBuildingPart: String
  wmnBuildingPartType: String
  wmnApartment: String
}

Authorize

Verify the validity of access token
- Return (401, 'Invalid access token') in case of validation fails
Verify that token is not expired
- in case of error - return (401, 'Invalid access token')
Check user scopes in order to perform this action (scope = 'person:read')
- Return (403, 'Your scope does not allow to access this resource. Missing allowances: person:read') in case of invalid scope(s)

Validate legal entity

Extract client_id from token.
Check legal entity status (status = ACTIVE)
- In case of error - return 409 ('client_id refers to legal entity that is not active')
Check client type (type = NHS)
- In case of error - return 403 ('You don't have permission to access this resource')

Validate request

Validate $.id

Check id is ID from mimir.dracs_divorce_acts

in case of error, return 404, "Such Divorce Act doesn't exist"

Service logic

Get Divorce Act data from mimir.dracs_divorce_acts by id
Render a response according to specification.