his_emr_api_lab 0.0.2

data/app/services/lab/results_service.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module Lab
+  module ResultsService
+    class << self
+      def create_results(test_id, params)
+        ActiveRecord::Base.transaction do
+          test = Lab::LabTest.find(test_id)
+          encounter = find_encounter(test, encounter_id: params[:encounter_id],
+                                           date: params[:date],
+                                           provider_id: params[:provider_id])
+
+          results_obs = create_results_obs(encounter, test, params[:date])
+          params[:measures].map { |measure| add_measure_to_results(results_obs, measure, params[:date]) }
+
+          Lab::ResultSerializer.serialize(results_obs)
+        end
+      end
+
+      private
+
+      def find_encounter(test, encounter_id: nil, date: nil, provider_id: nil)
+        return Encounter.find(encounter_id) if encounter_id
+
+        Encounter.create!(
+          patient_id: test.person_id,
+          program_id: test.encounter.program_id,
+          type: EncounterType.find_by_name!(Lab::Metadata::ENCOUNTER_TYPE_NAME),
+          encounter_datetime: date || Date.today,
+          provider_id: provider_id || User.current.user_id
+        )
+      end
+
+      # Creates the parent observation for results to which the different measures are attached
+      def create_results_obs(encounter, test, date)
+        Lab::LabResult.create!(
+          person_id: encounter.patient_id,
+          encounter_id: encounter.encounter_id,
+          concept_id: ConceptName.find_by_name!(Lab::Metadata::TEST_RESULT_CONCEPT_NAME).concept_id,
+          order_id: test.order_id,
+          obs_group_id: test.obs_id,
+          obs_datetime: date&.to_datetime || DateTime.now
+        )
+      end
+
+      def add_measure_to_results(results_obs, params, date)
+        validate_measure_params(params)
+
+        Observation.create!(
+          person_id: results_obs.person_id,
+          encounter_id: results_obs.encounter_id,
+          concept_id: params[:indicator][:concept_id],
+          obs_group_id: results_obs.obs_id,
+          obs_datetime: date&.to_datetime || DateTime.now,
+          **make_measure_value(params)
+        )
+      end
+
+      def validate_measure_params(params)
+        raise InvalidParameterError, 'measures.value is required' if params[:value].blank?
+
+        if params[:indicator]&.[](:concept_id).blank?
+          raise InvalidParameterError, 'measures.indicator.concept_id is required'
+        end
+
+        params
+      end
+
+      # Converts user provided measure values to observation_values
+      def make_measure_value(params)
+        obs_value = { value_modifier: params[:value_modifier] }
+        value_type = params[:value_type] || 'text'
+
+        case value_type.downcase
+        when 'numeric' then obs_value.merge(value_numeric: params[:value])
+        when 'boolean' then obs_value.merge(value_boolean: parse_boolen_value(params[:value]))
+        when 'coded' then obs_value.merge(value_coded: params[:value]) # Should we be collecting value_name_coded_id?
+        when 'text' then obs_value.merge(value_text: params[:value])
+        else raise InvalidParameterError, "Invalid value_type: #{params[:value_type]}"
+        end
+      end
+
+      def parse_boolen_value(string)
+        case string.downcase
+        when 'true' then true
+        when 'false' then false
+        else raise InvalidParameterError, "Invalid boolean value: #{string}"
+        end
+      end
+    end
+  end
+end

data/app/services/lab/tests_service.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+module Lab
+  ##
+  # Manage tests that have been ordered through the ordering service.
+  module TestsService
+    class << self
+      def find_tests(filters)
+        tests = Lab::LabTest.all
+
+        tests = filter_tests(tests, test_type_id: filters.delete(:test_type_id),
+                                    patient_id: filters.delete(:patient_id))
+
+        tests = filter_tests_by_results(tests) if %w[1 true].include?(filters[:pending_results]&.downcase)
+
+        tests = filter_tests_by_order(tests, accession_number: filters.delete(:accession_number),
+                                             order_date: filters.delete(:order_date),
+                                             specimen_type_id: filters.delete(:specimen_type_id))
+
+        tests.map { |test| Lab::TestSerializer.serialize(test) }
+      end
+
+      def create_tests(order, date, tests_params)
+        raise InvalidParameterError, 'tests are required' if tests_params.nil? || tests_params.empty?
+
+        Lab::LabTest.transaction do
+          tests_params.map do |params|
+            test = Lab::LabTest.create!(
+              concept_id: ConceptName.find_by_name!(Lab::Metadata::TEST_TYPE_CONCEPT_NAME)
+                                     .concept_id,
+              encounter_id: order.encounter_id,
+              order_id: order.order_id,
+              person_id: order.patient_id,
+              obs_datetime: date&.to_time || Time.now,
+              value_coded: params[:concept_id]
+            )
+
+            Lab::TestSerializer.serialize(test, order: order)
+          end
+        end
+      end
+
+      private
+
+      ##
+      # Filter a LabTests Relation.
+      def filter_tests(tests, test_type_id: nil, patient_id: nil)
+        tests = tests.where(value_coded: test_type_id) if test_type_id
+        tests = tests.where(person_id: patient_id) if patient_id
+
+        tests
+      end
+
+      ##
+      # Filter out any tests having results
+      def filter_tests_by_results(tests)
+        tests.where.not(obs_id: Lab::LabResult.all.select(:obs_group_id))
+      end
+
+      ##
+      # Filter LabTests Relation using their parent orders parameters.
+      def filter_tests_by_order(tests, accession_number: nil, order_date: nil, specimen_type_id: nil)
+        return tests unless accession_number || order_date || specimen_type_id
+
+        lab_orders = filter_orders(Lab::LabOrder.all, accession_number: accession_number,
+                                                      order_date: order_date,
+                                                      specimen_type_id: specimen_type_id)
+        tests.joins(:order).merge(lab_orders)
+      end
+
+      def filter_orders(orders, accession_number: nil, order_date: nil, specimen_type_id: nil)
+        if order_date
+          order_date = order_date.to_date
+          orders = orders.where('start_date >= ? AND start_date < ?', order_date, order_date + 1.day)
+        end
+
+        orders = orders.where(accession_number: accession_number) if accession_number
+        orders = orders.where(concept_id: specimen_type_id) if specimen_type_id
+
+        orders
+      end
+
+      def create_test(order, date, test_type_id)
+        create_order_observation(
+          order,
+          Lab::Metadata::TEST_TYPE_CONCEPT_NAME,
+          date,
+          value_coded: test_type_id
+        )
+      end
+    end
+  end
+end

data/config/routes.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+Lab::Engine.routes.draw do
+  resources :orders, path: 'api/v1/lab/orders'
+  resources :tests, path: 'api/v1/lab/tests', except: %i[update] do # ?pending=true to select tests without results?
+    resources :results, only: %i[index create destroy]
+  end
+
+  # Metadata
+  # TODO: Move the following to namespace /concepts
+  resources :specimen_types, only: %i[index], path: 'api/v1/lab/specimen_types'
+  resources :test_result_indicators, only: %i[index], path: 'api/v1/lab/test_result_indicators'
+  resources :test_types, only: %i[index], path: 'api/v1/lab/test_types'
+  resources :reasons_for_test, only: %i[index], path: 'api/v1/lab/reasons_for_test'
+end

data/db/migrate/20210126092910_create_lab_lab_accession_number_counters.rb

@@ -0,0 +1,12 @@
+class CreateLabLabAccessionNumberCounters < ActiveRecord::Migration[5.2]
+  def change
+    create_table :lab_accession_number_counters do |t|
+      t.date :date
+      t.bigint :value
+
+      t.timestamps
+
+      t.index %i[date], unique: true
+    end
+  end
+end

data/db/migrate/20210310115457_create_lab_lims_order_mappings.rb

@@ -0,0 +1,15 @@
+class CreateLabLimsOrderMappings < ActiveRecord::Migration[5.2]
+  def change
+    create_table :lab_lims_order_mappings do |t|
+      t.integer :lims_id, null: false, unique: true
+      t.integer :order_id, null: false, unique: true
+      t.datetime :pushed_at
+      t.datetime :pulled_at
+
+      t.timestamps
+
+      t.foreign_key :orders, primary_key: :order_id, column: :order_id
+      t.index :lims_id
+    end
+  end
+end

data/db/migrate/20210323080140_change_lims_id_to_string_in_lims_order_mapping.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+class ChangeLimsIdToStringInLimsOrderMapping < ActiveRecord::Migration[5.2]
+  def change
+    reversible do |direction|
+      direction.up do
+        change_column :lab_lims_order_mappings, :lims_id, :string, null: false
+      end
+
+      direction.down do
+        change_column :lab_lims_order_mappings, :lims_id, :integer, null: false
+      end
+    end
+  end
+end

data/db/migrate/20210326195504_add_order_revision_to_lims_order_mapping.rb

@@ -0,0 +1,5 @@
+class AddOrderRevisionToLimsOrderMapping < ActiveRecord::Migration[5.2]
+  def change
+    add_column :lab_lims_order_mappings, :revision, :string
+  end
+end

data/db/migrate/20210407071728_create_lab_lims_failed_imports.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+class CreateLabLimsFailedImports < ActiveRecord::Migration[5.2]
+  def change
+    create_table :lab_lims_failed_imports do |t|
+      t.string :lims_id, null: false
+      t.string :tracking_number, null: false
+      t.string :patient_nhid, null: false
+      t.string :reason, null: false
+      t.string :diff, limit: 2048
+
+      t.timestamps
+
+      t.index :lims_id
+      t.index :patient_nhid
+      t.index :tracking_number
+    end
+  end
+end

data/lib/couch_bum/couch_bum.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+require 'cgi'
+require 'couchrest'
+
+##
+# A CouchRest wrapper for the changes API.
+#
+# See: https://github.com/couchrest/couchrest
+class CouchBum
+  def initialize(database:, protocol: 'http', host: 'localhost', port: 5984, username: nil, password: nil)
+    @connection_string = make_connection_string(protocol, username, password, host, port, database)
+  end
+
+  ##
+  # Attaches to the Changes API and streams the updates to passed block.
+  #
+  # This is a blocking call that only stops when there are no more
+  # changes to pull or is explicitly terminated by calling +choke+
+  # within the passed block.
+  def binge_changes(since: 0, limit: nil, include_docs: nil, &block)
+    catch(:choke) do
+      extra_params = stringify_params(limit: limit, include_docs: include_docs)
+
+      changes = couch_rest(:get, "_changes?since=#{since}&#{extra_params}")
+      context = BingeContext.new(changes)
+      changes['results'].each { |change| context.instance_exec(change, &block) }
+    end
+  end
+
+  def couch_rest(method, route, *args, **kwargs)
+    CouchRest.send(method, expand_route(route), *args, **kwargs)
+  end
+
+  private
+
+  # Context under which the callback passed to binge_changes is executed.
+  class BingeContext
+    def initialize(changes)
+      @changes = changes
+    end
+
+    def choke
+      throw :choke
+    end
+
+    def last_seq
+      @changes['last_seq']
+    end
+
+    def pending
+      @changes['pending']
+    end
+  end
+
+  def make_connection_string(protocol, username, password, host, port, database)
+    auth = username ? "#{CGI.escape(username)}:#{CGI.escape(password)}@" : ''
+
+    "#{protocol}://#{auth}#{host}:#{port}/#{database}"
+  end
+
+  def expand_route(route)
+    route = route.gsub(%r{^/+}, '')
+
+    "#{@connection_string}/#{route}"
+  end
+
+  def stringify_params(params)
+    params.reduce('') do |str_params, entry|
+      name, value = entry
+      next params unless value
+
+      param = "#{name}=#{value}"
+      str_params.empty? ? param : "#{str_params}&#{param}"
+    end
+  end
+end

data/lib/generators/lab/install/USAGE

@@ -0,0 +1,9 @@
+Description:
+    Installs the Lab engine.
+
+Example:
+    rails generate lab:install
+
+    This will create:
+        config/initializers/rswag-ui-lab.rb
+        swagger/lab/v1/swagger.yaml

data/lib/generators/lab/install/install_generator.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Lab
+  class InstallGenerator < Rails::Generators::Base
+    source_root File.expand_path('templates', __dir__)
+
+    def copy_openapi_docs
+      copy_file('swagger.yaml', 'swagger/lab/v1/swagger.yaml')
+    end
+
+    def copy_rswag_initializer
+      copy_file('rswag-ui-lab.rb', 'config/initializers/rswag-ui-lab.rb')
+    end
+
+    def copy_worker
+      copy_file('start_worker.rb', 'bin/lab/start_worker.rb')
+    end
+  end
+end

data/lib/generators/lab/install/templates/rswag-ui-lab.rb

@@ -0,0 +1,5 @@
+require 'rswag/ui'
+
+Rswag::Ui.configure do |c|
+  c.swagger_endpoint '/api-docs/lab/v1/swagger.yaml', 'Lab API V1 Docs'
+end

data/lib/generators/lab/install/templates/start_worker.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'logger_multiplexor'
+
+Rails.logger = LoggerMultiplexor.new(Rails.root.join('log/lims-push.log'), $stdout)
+api = Lab::Lims::Api.new
+worker = Lab::Lims::Worker.new(api)
+
+def with_lock(lock_file)
+  File.open("log/#{lock_file}", File::RDWR | File::CREAT, 0o644) do |file|
+    unless file.flock(File::LOCK_EX | File::LOCK_NB)
+      Rails.logger.warn("Failed to start new process due to lock: #{lock_file}")
+      exit 2
+    end
+
+    file.rewind
+    file.puts("Process ##{Process.pid} started at #{Time.now}")
+
+    yield
+  end
+end
+
+case ARGV[0]&.downcase
+when 'push'
+  with_lock('lims-push.lock') { worker.push_orders }
+when 'pull'
+  with_lock('lims-pull.lock') { worker.pull_orders }
+else
+  warn 'Error: No or invalid action specified: Valid actions are push and pull'
+  warn 'USAGE: rails runner start_worker.rb push'
+  exit 1
+end

data/lib/generators/lab/install/templates/swagger.yaml

@@ -0,0 +1,682 @@
+---
+openapi: 3.0.1
+info:
+  title: API V1
+  version: v1
+paths:
+  "/api/v1/lab/orders":
+    post:
+      summary: Create order
+      tags:
+      - Orders
+      description: |
+        Create a lab order for a test.
+
+        Broadly a lab order consists of a test type and a number of specimens.
+        To each specimen is assigned a tracking number which can be used
+        to query the status and results of the specimen.
+      parameters: []
+      security:
+      - api_key: []
+      responses:
+        '201':
+          description: Created
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  type: object
+                  properties:
+                    id:
+                      type: integer
+                    patient_id:
+                      type: integer
+                    encounter_id:
+                      type: integer
+                    order_date:
+                      type: string
+                      format: datetime
+                    accession_number:
+                      type: string
+                    specimen:
+                      type: object
+                      properties:
+                        concept_id:
+                          type: integer
+                        name:
+                          type: string
+                      required:
+                      - concept_id
+                      - name
+                    requesting_clinician:
+                      type: string
+                      nullable: true
+                    target_lab:
+                      type: string
+                    reason_for_test:
+                      type: object
+                      properties:
+                        concept_id:
+                          type: integer
+                        name:
+                          type: string
+                      required:
+                      - concept_id
+                      - name
+                    tests:
+                      type: array
+                      items:
+                        type: object
+                        properties:
+                          id:
+                            type: integer
+                          concept_id:
+                            type: integer
+                          name:
+                            type: string
+                          result:
+                            type: object
+                            nullable: true
+                            properties:
+                              id:
+                                type: integer
+                              value:
+                                type: string
+                                nullable: true
+                              date:
+                                type: string
+                                format: datetime
+                                nullable: true
+                            required:
+                            - id
+                            - value
+                            - date
+                        required:
+                        - id
+                        - concept_id
+                        - name
+                  required:
+                  - id
+                  - specimen
+                  - reason_for_test
+                  - accession_number
+                  - patient_id
+                  - order_date
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                orders:
+                  type: array
+                  items:
+                    properties:
+                      encounter_id:
+                        type: integer
+                      specimen:
+                        type: object
+                        properties:
+                          concept_id:
+                            type: integer
+                            description: Specimen type concept ID (see GET /lab/test_types)
+                      tests:
+                        type: array
+                        items:
+                          type: object
+                          properties:
+                            concept_id:
+                              type: integer
+                              description: Test type concept ID (see GET /lab/test_types)
+                      requesting_clinician:
+                        type: string
+                        description: Fullname of the clinician requesting the test
+                          (defaults to orderer)
+                      target_lab:
+                        type: string
+                      reason_for_test_id:
+                        type: string
+                        description: One of routine, targeted, or confirmatory
+                    required:
+                    - encounter_id
+                    - tests
+                    - target_lab
+                    - reason_for_test_id
+    get:
+      summary: Retrieve lab orders
+      tags:
+      - Orders
+      description: Search/retrieve for lab orders.
+      security:
+      - api_key: []
+      parameters:
+      - name: patient_id
+        in: query
+        required: false
+        description: Filter orders using patient_id
+        schema:
+          type: integer
+      - name: accession_number
+        in: query
+        required: false
+        description: Filter orders using sample accession number
+        schema:
+          type: integer
+      - name: date
+        in: query
+        required: false
+        description: Select results falling on a specific date
+        schema:
+          type: date
+      - name: status
+        in: query
+        required: false
+        description: 'Filter by sample status: ordered, drawn'
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Success
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  type: object
+                  properties:
+                    id:
+                      type: integer
+                    patient_id:
+                      type: integer
+                    encounter_id:
+                      type: integer
+                    order_date:
+                      type: string
+                      format: datetime
+                    accession_number:
+                      type: string
+                    specimen:
+                      type: object
+                      properties:
+                        concept_id:
+                          type: integer
+                        name:
+                          type: string
+                      required:
+                      - concept_id
+                      - name
+                    requesting_clinician:
+                      type: string
+                      nullable: true
+                    target_lab:
+                      type: string
+                    reason_for_test:
+                      type: object
+                      properties:
+                        concept_id:
+                          type: integer
+                        name:
+                          type: string
+                      required:
+                      - concept_id
+                      - name
+                    tests:
+                      type: array
+                      items:
+                        type: object
+                        properties:
+                          id:
+                            type: integer
+                          concept_id:
+                            type: integer
+                          name:
+                            type: string
+                          result:
+                            type: object
+                            nullable: true
+                            properties:
+                              id:
+                                type: integer
+                              value:
+                                type: string
+                                nullable: true
+                              date:
+                                type: string
+                                format: datetime
+                                nullable: true
+                            required:
+                            - id
+                            - value
+                            - date
+                        required:
+                        - id
+                        - concept_id
+                        - name
+                  required:
+                  - id
+                  - specimen
+                  - reason_for_test
+                  - accession_number
+                  - patient_id
+                  - order_date
+  "/api/v1/lab/orders/{order_id}":
+    put:
+      summary: Update order
+      tags:
+      - Orders
+      description: Update an existing order
+      security:
+      - api_key: []
+      parameters:
+      - name: order_id
+        in: path
+        required: true
+        schema:
+          type: integer
+      responses:
+        '200':
+          description: Ok
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  type: object
+                  properties:
+                    id:
+                      type: integer
+                    patient_id:
+                      type: integer
+                    encounter_id:
+                      type: integer
+                    order_date:
+                      type: string
+                      format: datetime
+                    accession_number:
+                      type: string
+                    specimen:
+                      type: object
+                      properties:
+                        concept_id:
+                          type: integer
+                        name:
+                          type: string
+                      required:
+                      - concept_id
+                      - name
+                    requesting_clinician:
+                      type: string
+                      nullable: true
+                    target_lab:
+                      type: string
+                    reason_for_test:
+                      type: object
+                      properties:
+                        concept_id:
+                          type: integer
+                        name:
+                          type: string
+                      required:
+                      - concept_id
+                      - name
+                    tests:
+                      type: array
+                      items:
+                        type: object
+                        properties:
+                          id:
+                            type: integer
+                          concept_id:
+                            type: integer
+                          name:
+                            type: string
+                          result:
+                            type: object
+                            nullable: true
+                            properties:
+                              id:
+                                type: integer
+                              value:
+                                type: string
+                                nullable: true
+                              date:
+                                type: string
+                                format: datetime
+                                nullable: true
+                            required:
+                            - id
+                            - value
+                            - date
+                        required:
+                        - id
+                        - concept_id
+                        - name
+                  required:
+                  - id
+                  - specimen
+                  - reason_for_test
+                  - accession_number
+                  - patient_id
+                  - order_date
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                specimen:
+                  type: object
+                  properties:
+                    concept_id:
+                      type: integer
+                  required:
+                  - concept_id
+    delete:
+      summary: Void lab order
+      tags:
+      - Orders
+      description: |
+        Void a lab order and all it's associated records
+
+        This action voids an order, all it's linked tests and results.
+      security:
+      - api_key: []
+      parameters:
+      - name: order_id
+        in: path
+        required: true
+        schema:
+          type: integer
+      - name: reason
+        in: query
+        required: true
+        schema:
+          type: string
+      responses:
+        '204':
+          description: No Content
+  "/api/v1/lab/tests/{test_id}/results":
+    post:
+      summary: Add results to order
+      tags:
+      - Results
+      description: Attach results to specimens on order
+      parameters:
+      - name: test_id
+        in: path
+        required: true
+        schema:
+          type: integer
+      security:
+      - api_key: []
+      responses:
+        '201':
+          description: Created
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                encounter_id:
+                  type: integer
+                provider_id:
+                  type: integer
+                date:
+                  type: string
+                measures:
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      indicator:
+                        type: object
+                        properties:
+                          concept_id:
+                            type: integer
+                            description: Concept ID of a test result indicator for
+                              this test (see GET /test_result_indicators)
+                          required:
+                          - concept_id
+                      value:
+                        type: string
+                        example: LDL
+                      value_modifier:
+                        type: string
+                        example: "="
+                      value_type:
+                        type: string
+                        enum:
+                        - text
+                        - boolean
+                        - numeric
+                        - coded
+                        description: Determines under what column the value is to
+                          be saved under in the obs table (defaults to text)
+                        example: text
+                    required:
+                    - indicator
+                    - value
+              required:
+              - measures
+  "/api/v1/lab/specimen_types":
+    get:
+      summary: Specimen types
+      tags:
+      - Concepts
+      description: Retrieve all specimen types
+      security:
+      - api_key: []
+      parameters:
+      - name: test_type
+        in: query
+        required: false
+        description: Select specimen types having this test type only
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Success
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  type: object
+                  properties:
+                    concept_id:
+                      type: integer
+                    name:
+                      type: string
+                required:
+                - concept_id
+                - name
+  "/api/v1/lab/test_result_indicators":
+    get:
+      summary: Test Result Indicators
+      tags:
+      - Concepts
+      description: Retrieve all result indicators for a given test
+      security:
+      - api_key: []
+      parameters:
+      - name: test_type_id
+        in: query
+        required: true
+        description: Concept ID for the desired test
+        schema:
+          type: integer
+      responses:
+        '200':
+          description: Ok
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  type: object
+                  properties:
+                    concept_id:
+                      type: integer
+                    name:
+                      type: string
+                  required:
+                  - concept_id
+                  - name
+  "/api/v1/lab/test_types":
+    get:
+      summary: Test types
+      tags:
+      - Concepts
+      description: Retrieve all test types
+      security:
+      - api_key: []
+      parameters:
+      - name: specimen_type
+        in: query
+        required: false
+        description: Select test types having this specimen type only
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Success
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  type: object
+                  properties:
+                    concept_id:
+                      type: integer
+                    name:
+                      type: string
+                required:
+                - concept_id
+                - name
+  "/api/v1/lab/tests":
+    get:
+      summary: Search for tests
+      tags:
+      - Tests
+      description: 'Search for tests by accession number, date and other parameters.
+
+        '
+      parameters:
+      - name: accession_number
+        in: query
+        required: false
+        schema:
+          type: string
+      - name: test_type_id
+        in: query
+        required: false
+        schema:
+          type: integer
+      - name: specimen_type_id
+        in: query
+        required: false
+        schema:
+          type: integer
+      - name: patient_id
+        in: query
+        required: false
+        schema:
+          type: integer
+      - name: order_date
+        in: query
+        required: false
+        schema:
+          type: boolean
+      responses:
+        '200':
+          description: Okay
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  type: object
+                  properties:
+                    id:
+                      type: integer
+                    concept_id:
+                      type: integer
+                    name:
+                      type: string
+                    order:
+                      order_id:
+                        type: string
+                      accession_number:
+                        type: string
+    post:
+      summary: Add tests to an existing order
+      tags:
+      - Tests
+      description: |
+        Add tests to an existing order.
+
+        An order can be created without specifying tests.
+        This endpoint allows one to add tests to that order.
+      parameters: []
+      security:
+      - api_key: []
+      responses:
+        '201':
+          description: Created
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  type: object
+                  properties:
+                    id:
+                      type: integer
+                    concept_id:
+                      type: integer
+                    name:
+                      type: string
+                    order:
+                      order_id:
+                        type: string
+                      accession_number:
+                        type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                order_id:
+                  type: integer
+                tests:
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      concept_id:
+                        type: integer
+                        description: Test type concept ID
+                    required:
+                    - concept_id
+              required:
+              - order_id
+              - tests
+servers:
+- url: http://{defaultHost}
+  variables:
+    defaultHost:
+      default: localhost:3000
+components:
+  securitySchemes:
+    api_key:
+      type: apiKey
+      name: Authorization
+      in: header
+    bearer:
+      type: bearer
+      name: Authorization
+      in: header