eir_report_interface 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4c2101ad1667578c8d2fee14528de9128b9fdd3d4839fe9e5a89141fc04e11d6
+  data.tar.gz: 6ad64f409224db7d3b2be53bc79df2e032699e75e041f01d49b9bcf81fbdd7e6
+SHA512:
+  metadata.gz: e90e483171a248a325eacab6fe09268ba84b3d2283c7e5d3e30f119bf253a3521211eb55218fd94dc6d948eaac20667415d26dca442e42104d08049310df5c9f
+  data.tar.gz: ffc127e7d399bbb18189afe0cae0f7f0e94abec07bd3b992043e50544ba41365cd400e71a33077b6325914b6ed3fade34486daab17c579a79bacdc62d6d6d9b2

data/README.md

@@ -0,0 +1,2 @@
+# EirReportInterface
+

data/Rakefile

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+task default: %i[]

data/app/assets/config/eir_report_interface_manifest.js

@@ -0,0 +1,2 @@
+//= link_directory ../javascripts/eir_report_interface .js
+//= link_directory ../stylesheets/eir_report_interface .css

data/app/assets/javascripts/eir_report_interface/application.js

@@ -0,0 +1,15 @@
+// This is a manifest file that'll be compiled into application.js, which will include all the files
+// listed below.
+//
+// Any JavaScript/Coffee file within this directory, lib/assets/javascripts, vendor/assets/javascripts,
+// or any plugin's vendor/assets/javascripts directory can be referenced here using a relative path.
+//
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
+// compiled file. JavaScript code in this file should be added after the last require_* statement.
+//
+// Read Sprockets README (https://github.com/rails/sprockets#sprockets-directives) for details
+// about supported directives.
+//
+//= require rails-ujs
+//= require activestorage
+//= require_tree .

data/app/assets/stylesheets/eir_report_interface/application.css

@@ -0,0 +1,15 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
+ * files in this directory. Styles in this file should be added after the last require_* statement.
+ * It is generally better to create a new file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */

data/app/controllers/eir_report_interface/application_controller.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# ApplicationController serves as the base controller for all controllers
+module EIRReportInterface
+  # within the EIRReportInterface module. It inherits from ActionController::Base
+  # and includes common configurations and protections for the controllers.
+  class ApplicationController < ActionController::Base
+    # Protects the application from Cross-Site Request Forgery (CSRF) attacks.
+    # Uses the :exception strategy to raise an exception when a CSRF attack is detected.
+    protect_from_forgery with: :exception
+  end
+end

data/app/controllers/eir_report_interface/eir_report_interface_controller.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+# EIRReportInterface is a module that provides reporting services
+# related to the EIR (Electronic Immunization Registry).
+module EIRReportInterface
+  # EIRReportInterfaceController handles requests for generating weeks and months data.
+  class EIRReportInterfaceController < ::ApplicationController
+    # Generates weeks data and renders it as JSON.
+    def weeks_generator
+      render json: service.weeks_generator
+    end
+
+    # Generates months data and renders it as JSON.
+    def months_generator
+      render json: service.months_generator
+    end
+
+    # Provides access to the service object.
+    def service
+      EIRReportInterface::EIRReportInterfaceService
+    end
+  end
+end

data/app/helpers/eir_report_interface/application_helper.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module EIRReportInterface
+  # ApplicationHelper serves as a container for helper methods used across views in the EIRReportInterface module.
+  # It is intended to assist with view-related logic and presentation.
+  module ApplicationHelper
+  end
+end

data/app/jobs/eir_report_interface/application_job.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module EIRReportInterface
+  # ApplicationJob serves as the base class for all jobs in the EIRReportInterface module.
+  # It inherits from ActiveJob::Base, making it a part of the ActiveJob framework.
+  class ApplicationJob < ActiveJob::Base
+  end
+end

data/app/mailers/eir_report_interface/application_mailer.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module EIRReportInterface
+  # ApplicationMailer serves as the base class for all mailers in the EIRReportInterface module.
+  # It provides default settings and layout configurations for the mailers.
+  class ApplicationMailer < ActionMailer::Base
+    default from: 'from@example.com'
+    layout 'mailer'
+  end
+end

data/app/models/eir_report_interface/application_record.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module EIRReportInterface
+  # ApplicationRecord serves as the abstract base class for all models in the EIRReportInterface module.
+  # It inherits from ActiveRecord::Base, making it a part of the ActiveRecord ORM system.
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/services/eir_report_interface/eir_report_interface.rb

@@ -0,0 +1,138 @@
+# frozen_string_literal: true
+
+require 'csv'
+require 'rest-client'
+require 'json'
+
+# EIRReportInterface is a module that provides reporting services
+# related to the EIR (Electronic Immunization Registry).
+module EIRReportInterface
+  # EIRReportInterfaceService is a module within EIRReportInterface
+  # that provides various service methods for reporting and data disaggregation.
+  module EIRReportInterfaceService
+    class << self
+      # Reads and parses settings from a JSON file.
+      # @return [Hash] Parsed JSON configuration
+      def settings
+        file = File.read(Rails.root.join('db', 'idsr_metadata', 'idsr_ohsp_settings.json'))
+        JSON.parse(file)
+      end
+
+      # Reads and parses server configuration from a YAML file.
+      # @return [Hash] Parsed YAML configuration
+      def server_config
+        YAML.load_file("#{Rails.root}/config/application.yml")
+      end
+
+      # Disaggregates data based on the provided criteria.
+      # @param disaggregate_key [String] The key for disaggregation (e.g., 'less', 'greater')
+      # @param concept_ids [Array<Integer>] The concept IDs to filter by
+      # @param start_date [Date] The start date for the date range
+      # @param end_date [Date] The end date for the date range
+      # @param type [EncounterType] The encounter type
+      # @return [Hash] A hash containing the disaggregated data
+      def disaggregate(disaggregate_key, concept_ids, start_date, end_date, type)
+        data = fetch_data(concept_ids, start_date, end_date, type)
+        { 'ids' => filter_data(data, disaggregate_key) }
+      end
+
+      # Fetches data from the database based on the provided criteria.
+      # @param concept_ids [Array<Integer>] The concept IDs to filter by
+      # @param start_date [Date] The start date for the date range
+      # @param end_date [Date] The end date for the date range
+      # @param type [EncounterType] The encounter type
+      # @return [ActiveRecord::Relation] The fetched data
+      def fetch_data(concept_ids, start_date, end_date, type)
+        Encounter.where(
+          'encounter_datetime BETWEEN ? AND ? AND encounter_type = ? AND value_coded IN (?) AND concept_id IN (6543, 6542)',
+          start_date.to_date.strftime('%Y-%m-%d 00:00:00'),
+          end_date.to_date.strftime('%Y-%m-%d 23:59:59'), type.id, concept_ids
+        ).joins(
+          'INNER JOIN obs ON obs.encounter_id = encounter.encounter_id
+           INNER JOIN person p ON p.person_id = encounter.patient_id'
+        ).select('encounter.encounter_type, obs.value_coded, p.*')
+      end
+
+      # Filters data based on the disaggregate key.
+      # @param data [ActiveRecord::Relation] The data to filter
+      # @param disaggregate_key [String] The key for disaggregation (e.g., 'less', 'greater')
+      # @return [Array<Integer>] The filtered IDs
+      def filter_data(data, disaggregate_key)
+        filtered_data = case disaggregate_key
+                        when 'less'
+                          data.select { |record| calculate_age(record['birthdate']) < 5 }
+                        when 'greater'
+                          data.select { |record| calculate_age(record['birthdate']) >= 5 }
+                        else
+                          []
+                        end
+        filtered_data.collect { |record| record['person_id'] }
+      end
+
+      # Generates a hash of months with their respective date ranges.
+      # @return [Array<Array<String>>] An array of month-date range pairs
+      def months_generator
+        months = {}
+        count = 1
+        curr_date = Date.today
+
+        while count < 13
+          curr_date -= 1.month
+          months[curr_date.strftime('%Y%m')] = [
+            curr_date.strftime('%B-%Y'),
+            "#{curr_date.beginning_of_month} to #{curr_date.end_of_month}"
+          ]
+          count += 1
+        end
+
+        months.to_a
+      end
+
+      # Generates a hash of weeks with their respective date ranges.
+      # @return [Array<Array<String>>] An array of week-date range pairs
+      def weeks_generator
+        weeks = {}
+        first_day = (Date.today - 11.months).at_beginning_of_month
+        add_initial_week(weeks, first_day)
+
+        first_monday = first_day.next_week(:monday)
+
+        while first_monday <= Date.today
+          add_week(weeks, first_monday)
+          first_monday += 7
+        end
+
+        this_wk = "#{Date.today.year}W#{Date.today.cweek}"
+        weeks.reject { |key, _| key == this_wk }.to_a
+      end
+
+      # Adds the initial week to the weeks hash.
+      # @param weeks [Hash] The hash to add the week to
+      # @param first_day [Date] The first day of the initial week
+      def add_initial_week(weeks, first_day)
+        wk_of_first_day = first_day.cweek
+        return unless wk_of_first_day > 1
+
+        wk = "#{first_day.prev_year.year}W#{wk_of_first_day}"
+        dates = "#{first_day - first_day.wday + 1} to #{first_day - first_day.wday + 1 + 6}"
+        weeks[wk] = dates
+      end
+
+      # Adds a week to the weeks hash.
+      # @param weeks [Hash] The hash to add the week to
+      # @param first_monday [Date] The first Monday of the week
+      def add_week(weeks, first_monday)
+        wk = "#{first_monday.year}W#{first_monday.cweek}"
+        dates = "#{first_monday} to #{first_monday + 6}"
+        weeks[wk] = dates
+      end
+
+      # Calculates the age based on the date of birth.
+      # @param dob [Date] The date of birth
+      # @return [Integer] The calculated age
+      def calculate_age(dob)
+        ((Date.today - dob.to_date).to_i / 365).rescue(0)
+      end
+    end
+  end
+end

data/app/views/layouts/eir_report_interface/application.html.erb

@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>EIR Report Interface</title>
+  <%= csrf_meta_tags %>
+  <%= csp_meta_tag %>
+
+  <%= stylesheet_link_tag    "eir_report_interface/application", media: "all" %>
+  <%= javascript_include_tag "eir_report_interface/application" %>
+</head>
+<body>
+
+<%= yield %>
+
+</body>
+</html>

data/config/routes.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+EIRReportInterface::Engine.routes.each do
+  get '/get_months', to: 'eir_report_interface#months_generator'
+end

data/lib/eir_report_interface/engine.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module EIRReportInterface
+  # Engine class for the EIRReportInterface gem.
+  #
+  # This class is used to integrate the EIRReportInterface functionality into a Rails application.
+  # It isolates the namespace for the gem to avoid conflicts with other parts of the application.
+  #
+  # For more information about configuring and using this engine, see the README file.
+  class Engine < ::Rails::Engine
+    isolate_namespace EIRReportInterface
+  end
+end

data/lib/eir_report_interface/railtie.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require 'rails/railtie'
+
+module EIRReportInterface
+  # Railtie class for the EIRReportInterface gem.
+  #
+  # This Railtie integrates the EIRReportInterface functionality into a Rails application.
+  # It allows you to configure initialization options for the gem within a Rails context.
+  #
+  # For more information about configuring and using this Railtie, see the README file of the gem.
+  class Railtie < Rails::Railtie
+    initializer 'eir_report_interface.configure_rails_initialization' do
+      # Custom initialization code
+    end
+  end
+end

data/lib/eir_report_interface/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module EIRReportInterface
+  VERSION = '0.1.0'
+end

data/lib/eir_report_interface.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative 'eir_report_interface/engine'
+
+module EIRReportInterface
+  # Example usage of single-quoted string
+  MESSAGE = 'Your code goes here...'
+end

metadata

@@ -0,0 +1,139 @@
+--- !ruby/object:Gem::Specification
+name: eir_report_interface
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- dominickasanga
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2024-07-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 7.0.6
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 7.0.6
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: mysql2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.6
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.6
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+description: Write a longer description or delete this line.
+email:
+- dominickasanga@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- Rakefile
+- app/assets/config/eir_report_interface_manifest.js
+- app/assets/javascripts/eir_report_interface/application.js
+- app/assets/stylesheets/eir_report_interface/application.css
+- app/controllers/eir_report_interface/application_controller.rb
+- app/controllers/eir_report_interface/eir_report_interface_controller.rb
+- app/helpers/eir_report_interface/application_helper.rb
+- app/jobs/eir_report_interface/application_job.rb
+- app/mailers/eir_report_interface/application_mailer.rb
+- app/models/eir_report_interface/application_record.rb
+- app/services/eir_report_interface/eir_report_interface.rb
+- app/views/layouts/eir_report_interface/application.html.erb
+- config/routes.rb
+- lib/eir_report_interface.rb
+- lib/eir_report_interface/engine.rb
+- lib/eir_report_interface/railtie.rb
+- lib/eir_report_interface/version.rb
+homepage: https://github.com/LUKEINTERNATIONAL/eir_report_interface.git
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/LUKEINTERNATIONAL/eir_report_interface.git
+  source_code_uri: https://github.com/LUKEINTERNATIONAL/eir_report_interface.git
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.1
+signing_key:
+specification_version: 4
+summary: Write a short summary, because RubyGems requires one.
+test_files: []