description: |-
  A report about a care program based on showing a number of ratios, such as 'how many people in your practice have diabetes', or 'for all diabetes patients in your care with a recent blood pressure measurement, how do these blood pressure measurements split into "problematic" / "concern" / "okay" categories
type: object
required:
  - key
  - name
  - refDate
  - calculating
properties:
  gpis:
    $ref: 'GPIS.yaml'
  key:
    description: Unique identifier, not to be shown to the user, for referring to this indicator set in other API calls
    type: string
    example: ZOO-dm
  name:
    description: Human readable dutch text; should fit in one line.
    type: string
    example: Diabetes Mellitus type 2 – per InEen 2023 accreditatie
  refDate:
    description: 'All calculations are done based on this date (dutch: _peildatum_).'
    $ref: ./date.yaml
  calculating:
    description: |-
      Calculating an indicator set report takes some time; this API responds with a `calculating` value of less than 1.0 and
      no `chapters` section (thus, no data). Call this endpoint a few times to get status updates. Once calculation is complete,
      `1.0` will be returned and `chapters` will be provided.
    format: number
    minimum: 0.0
    maximum: 1.0
  chapters:
    description: |-
        Each chapter has a title and contains 1 or more indicators.
    type: array
    items:
      type: object
      required:
        - title
        - indicatorGroups
      properties:
        title:
          description: In dutch, plain text formatted; should fit on one line.
          type: string
          example: Populatie
        indicatorGroups:
          description: |-
            A chapter contains 1 or more indicator groups. An indicator group is an array of indicators which should
            always be shown together; they are each other's context. These arrays are never empty, but often contain
            just one indicator. It is extremely rare for such a set to contain more than 2.
          type: array
          items:
            type: array
            items:
              $ref: 'Indicator.yaml'