Slot classes (#27514)

* Slot classes

Slot classes

* copilot suggestion

copilot suggestion

* implemented the two suggestions from PR review

implemented the two suggestions from PR review, updated tests

Author: lee-delarm6

modules/vaos/app/models/vaos/v2/unified/base_slot.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module VAOS
+  module V2
+    module Unified
+      class BaseSlot
+        attr_accessor :id, :start, :end, :provider_id, :provider_type
+
+        def initialize(attrs = {})
+          attrs.each { |key, value| send(:"#{key}=", value) if respond_to?(:"#{key}=") }
+        end
+      end
+    end
+  end
+end

modules/vaos/app/models/vaos/v2/unified/eps_slot.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module VAOS
+  module V2
+    module Unified
+      class EpsSlot < BaseSlot
+        DURATION_SEGMENT_PATTERN = /\A(?:(?<hours>\d+)h)?(?:(?<minutes>\d+)m)?(?:(?<seconds>\d+)s)?\z/
+
+        attr_accessor :provider_service_id
+
+        def initialize(attrs = {})
+          super
+          self.provider_type = 'community_care'
+        end
+
+        # Builds an EpsSlot from an EPS slot response (Hash).
+        # EPS slots carry an opaque composite ID and a providerServiceId.
+        # EPS slots may not include an explicit end time; when missing, we derive it from the
+        # duration segment in the slot ID when possible, otherwise it is left nil.
+        def self.from_eps_slot(slot)
+          slot = slot.to_h if slot.is_a?(OpenStruct)
+
+          new(
+            id: slot[:id],
+            start: slot[:start],
+            end: normalized_end_time(slot),
+            provider_id: slot[:provider_service_id],
+            provider_service_id: slot[:provider_service_id]
+          )
+        end
+
+        def self.normalized_end_time(slot)
+          return slot[:end] if slot[:end].present?
+
+          duration = duration_from_slot_id(slot[:id])
+          return nil if slot[:start].blank? || duration.nil?
+
+          start_time = Time.zone.parse(slot[:start].to_s)
+          return nil if start_time.nil?
+
+          (start_time.utc + duration).iso8601
+        end
+
+        def self.duration_from_slot_id(slot_id)
+          duration_segment = slot_id.to_s.split('|')[3]
+          return nil if duration_segment.blank?
+
+          match = DURATION_SEGMENT_PATTERN.match(duration_segment)
+          return nil unless match
+
+          match[:hours].to_i.hours + match[:minutes].to_i.minutes + match[:seconds].to_i.seconds
+        end
+      end
+    end
+  end
+end

modules/vaos/app/models/vaos/v2/unified/va_slot.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module VAOS
+  module V2
+    module Unified
+      class VASlot < BaseSlot
+        attr_accessor :location_id, :clinic_ien
+
+        def initialize(attrs = {})
+          super
+          self.provider_type = 'va'
+        end
+
+        # Builds a VASlot from a VAOS slot response (OpenStruct or Hash).
+        # VA slots carry an opaque encoded ID plus embedded location/clinic context.
+        def self.from_vaos_slot(slot, location_id: nil)
+          slot = slot.to_h if slot.is_a?(OpenStruct)
+
+          clinic_ien_value = slot.dig(:clinic, :clinic_ien)
+          location_id_value = location_id || slot.dig(:location, :vha_facility_id)
+
+          new(
+            id: slot[:id],
+            start: slot[:start],
+            end: slot[:end],
+            provider_id: clinic_ien_value,
+            location_id: location_id_value,
+            clinic_ien: clinic_ien_value
+          )
+        end
+      end
+    end
+  end
+end

modules/vaos/spec/models/vaos/v2/unified/base_slot_spec.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require 'rails_helper'
+
+RSpec.describe VAOS::V2::Unified::BaseSlot do
+  describe '#initialize' do
+    it 'accepts attributes via hash' do
+      slot = described_class.new(
+        id: 'slot-123',
+        start: '2025-01-02T11:00:00Z',
+        end: '2025-01-02T11:30:00Z',
+        provider_id: 'provider-456',
+        provider_type: 'va'
+      )
+
+      expect(slot.id).to eq('slot-123')
+      expect(slot.start).to eq('2025-01-02T11:00:00Z')
+      expect(slot.end).to eq('2025-01-02T11:30:00Z')
+      expect(slot.provider_id).to eq('provider-456')
+      expect(slot.provider_type).to eq('va')
+    end
+
+    it 'defaults all attributes to nil' do
+      slot = described_class.new
+
+      expect(slot.id).to be_nil
+      expect(slot.start).to be_nil
+      expect(slot.end).to be_nil
+      expect(slot.provider_id).to be_nil
+      expect(slot.provider_type).to be_nil
+    end
+
+    it 'ignores unknown attributes' do
+      slot = described_class.new(id: 'slot-123', unknown_field: 'ignored')
+
+      expect(slot.id).to eq('slot-123')
+      expect(slot).not_to respond_to(:unknown_field)
+    end
+  end
+end

modules/vaos/spec/models/vaos/v2/unified/eps_slot_spec.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require 'rails_helper'
+
+RSpec.describe VAOS::V2::Unified::EpsSlot do
+  describe '#initialize' do
+    it 'sets provider_type to community_care' do
+      slot = described_class.new
+      expect(slot.provider_type).to eq('community_care')
+    end
+  end
+
+  describe '.from_eps_slot' do
+    let(:eps_slot_id) do
+      '5vuTac8v-practitioner-1-role-2|e43a19a8-b0cb-4dcf-befa-8cc511c3999b|' \
+        '2025-01-02T11:00:00Z|30m0s|1736636444704|ov'
+    end
+
+    let(:eps_slot) do
+      {
+        id: eps_slot_id,
+        provider_service_id: '9mN718pH',
+        start: '2025-01-02T11:00:00Z',
+        end: nil
+      }
+    end
+
+    it 'maps EPS slot fields to EpsSlot' do
+      slot = described_class.from_eps_slot(eps_slot)
+
+      expect(slot.id).to eq(eps_slot_id)
+      expect(slot.start).to eq('2025-01-02T11:00:00Z')
+      expect(slot.end).to eq('2025-01-02T11:30:00Z')
+      expect(slot.provider_id).to eq('9mN718pH')
+      expect(slot.provider_type).to eq('community_care')
+      expect(slot.provider_service_id).to eq('9mN718pH')
+    end
+
+    it 'works with OpenStruct input' do
+      slot = described_class.from_eps_slot(OpenStruct.new(eps_slot))
+
+      expect(slot.id).to include('5vuTac8v-practitioner')
+      expect(slot.provider_type).to eq('community_care')
+    end
+
+    it 'handles missing provider_service_id gracefully' do
+      eps_slot.delete(:provider_service_id)
+      slot = described_class.from_eps_slot(eps_slot)
+
+      expect(slot.provider_id).to be_nil
+      expect(slot.provider_service_id).to be_nil
+    end
+
+    it 'returns nil end when slot ID has no parseable duration segment' do
+      eps_slot[:id] = 'no-pipe-segments'
+      eps_slot[:end] = nil
+      slot = described_class.from_eps_slot(eps_slot)
+
+      expect(slot.end).to be_nil
+    end
+
+    it 'preserves an explicit end time when present' do
+      eps_slot[:end] = '2025-01-02T11:45:00Z'
+      slot = described_class.from_eps_slot(eps_slot)
+
+      expect(slot.end).to eq('2025-01-02T11:45:00Z')
+    end
+  end
+end

modules/vaos/spec/models/vaos/v2/unified/va_slot_spec.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require 'rails_helper'
+
+RSpec.describe VAOS::V2::Unified::VASlot do
+  describe '#initialize' do
+    it 'sets provider_type to va' do
+      slot = described_class.new
+      expect(slot.provider_type).to eq('va')
+    end
+  end
+
+  describe '.from_vaos_slot' do
+    let(:vaos_slot) do
+      {
+        id: '3230323530313032323A323033303030303030303030',
+        start: '2025-01-02T20:30:00Z',
+        end: '2025-01-02T21:00:00Z',
+        location: { vha_facility_id: '757GC', name: 'Marion VA Clinic' },
+        clinic: { clinic_ien: '455', name: 'MARION CBOC PODIATRY' },
+        practitioner: { name: 'Doe, John D, MD' }
+      }
+    end
+
+    it 'maps VAOS slot fields to VaSlot' do
+      slot = described_class.from_vaos_slot(vaos_slot)
+
+      expect(slot.id).to eq('3230323530313032323A323033303030303030303030')
+      expect(slot.start).to eq('2025-01-02T20:30:00Z')
+      expect(slot.end).to eq('2025-01-02T21:00:00Z')
+      expect(slot.provider_id).to eq('455')
+      expect(slot.provider_type).to eq('va')
+      expect(slot.location_id).to eq('757GC')
+      expect(slot.clinic_ien).to eq('455')
+    end
+
+    it 'allows location_id override via keyword argument' do
+      slot = described_class.from_vaos_slot(vaos_slot, location_id: '983')
+
+      expect(slot.provider_id).to eq('455')
+      expect(slot.location_id).to eq('983')
+    end
+
+    it 'works with OpenStruct input' do
+      slot = described_class.from_vaos_slot(OpenStruct.new(vaos_slot))
+
+      expect(slot.id).to eq('3230323530313032323A323033303030303030303030')
+      expect(slot.provider_type).to eq('va')
+    end
+
+    it 'handles missing location gracefully' do
+      vaos_slot.delete(:location)
+      slot = described_class.from_vaos_slot(vaos_slot)
+
+      expect(slot.provider_id).to eq('455')
+      expect(slot.location_id).to be_nil
+    end
+
+    it 'handles missing clinic gracefully' do
+      vaos_slot.delete(:clinic)
+      slot = described_class.from_vaos_slot(vaos_slot)
+
+      expect(slot.clinic_ien).to be_nil
+    end
+  end
+end