mindee 3.15.0 → 3.17.0

data/lib/mindee/product/fr/health_card/health_card_v1_document.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require_relative '../../../parsing'
+
+module Mindee
+  module Product
+    module FR
+      module HealthCard
+        # Health Card API version 1.0 document data.
+        class HealthCardV1Document < Mindee::Parsing::Common::Prediction
+          include Mindee::Parsing::Standard
+          # The given names of the card holder.
+          # @return [Array<Mindee::Parsing::Standard::StringField>]
+          attr_reader :given_names
+          # The date when the carte vitale document was issued.
+          # @return [Mindee::Parsing::Standard::DateField]
+          attr_reader :issuance_date
+          # The social security number of the card holder.
+          # @return [Mindee::Parsing::Standard::StringField]
+          attr_reader :social_security
+          # The surname of the card holder.
+          # @return [Mindee::Parsing::Standard::StringField]
+          attr_reader :surname
+
+          # @param prediction [Hash]
+          # @param page_id [Integer, nil]
+          def initialize(prediction, page_id)
+            super()
+            @given_names = []
+            prediction['given_names'].each do |item|
+              @given_names.push(StringField.new(item, page_id))
+            end
+            @issuance_date = DateField.new(prediction['issuance_date'], page_id)
+            @social_security = StringField.new(prediction['social_security'], page_id)
+            @surname = StringField.new(prediction['surname'], page_id)
+          end
+
+          # @return [String]
+          def to_s
+            given_names = @given_names.join("\n #{' ' * 15}")
+            out_str = String.new
+            out_str << "\n:Given Name(s): #{given_names}".rstrip
+            out_str << "\n:Surname: #{@surname}".rstrip
+            out_str << "\n:Social Security Number: #{@social_security}".rstrip
+            out_str << "\n:Issuance Date: #{@issuance_date}".rstrip
+            out_str[1..].to_s
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mindee/product/fr/health_card/health_card_v1_page.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative '../../../parsing'
+require_relative 'health_card_v1_document'
+
+module Mindee
+  module Product
+    module FR
+      module HealthCard
+        # Health Card API version 1.0 page data.
+        class HealthCardV1Page < Mindee::Parsing::Common::Page
+          # @param prediction [Hash]
+          def initialize(prediction)
+            super(prediction)
+            @prediction = HealthCardV1PagePrediction.new(
+              prediction['prediction'],
+              prediction['id']
+            )
+          end
+        end
+
+        # Health Card V1 page prediction.
+        class HealthCardV1PagePrediction < HealthCardV1Document
+          # @return [String]
+          def to_s
+            out_str = String.new
+            out_str << "\n#{super}"
+            out_str
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mindee/product/fr/payslip/payslip_v3.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require_relative '../../../parsing'
+require_relative 'payslip_v3_document'
+require_relative 'payslip_v3_page'
+
+module Mindee
+  module Product
+    module FR
+      # Payslip module.
+      module Payslip
+        # Payslip API version 3 inference prediction.
+        class PayslipV3 < Mindee::Parsing::Common::Inference
+          @endpoint_name = 'payslip_fra'
+          @endpoint_version = '3'
+
+          # @param prediction [Hash]
+          def initialize(prediction)
+            super
+            @prediction = PayslipV3Document.new(prediction['prediction'], nil)
+            @pages = []
+            prediction['pages'].each do |page|
+              if page.key?('prediction') && !page['prediction'].nil? && !page['prediction'].empty?
+                @pages.push(PayslipV3Page.new(page))
+              end
+            end
+          end
+
+          class << self
+            # Name of the endpoint for this product.
+            # @return [String]
+            attr_reader :endpoint_name
+            # Version for this product.
+            # @return [String]
+            attr_reader :endpoint_version
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mindee/product/fr/payslip/payslip_v3_bank_account_detail.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require_relative '../../../parsing'
+
+module Mindee
+  module Product
+    module FR
+      module Payslip
+        # Information about the employee's bank account.
+        class PayslipV3BankAccountDetail < Mindee::Parsing::Standard::FeatureField
+          include Mindee::Parsing::Standard
+          # The name of the bank.
+          # @return [String]
+          attr_reader :bank_name
+          # The IBAN of the bank account.
+          # @return [String]
+          attr_reader :iban
+          # The SWIFT code of the bank.
+          # @return [String]
+          attr_reader :swift
+
+          # @param prediction [Hash]
+          # @param page_id [Integer, nil]
+          def initialize(prediction, page_id)
+            super(prediction, page_id)
+            @bank_name = prediction['bank_name']
+            @iban = prediction['iban']
+            @swift = prediction['swift']
+            @page_id = page_id
+          end
+
+          # @return [Hash]
+          def printable_values
+            printable = {}
+            printable[:bank_name] = format_for_display(@bank_name)
+            printable[:iban] = format_for_display(@iban)
+            printable[:swift] = format_for_display(@swift)
+            printable
+          end
+
+          # @return [String]
+          def to_s
+            printable = printable_values
+            out_str = String.new
+            out_str << "\n  :Bank Name: #{printable[:bank_name]}"
+            out_str << "\n  :IBAN: #{printable[:iban]}"
+            out_str << "\n  :SWIFT: #{printable[:swift]}"
+            out_str
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mindee/product/fr/payslip/payslip_v3_document.rb

@@ -0,0 +1,166 @@
+# frozen_string_literal: true
+
+require_relative '../../../parsing'
+require_relative 'payslip_v3_pay_period'
+require_relative 'payslip_v3_employee'
+require_relative 'payslip_v3_employer'
+require_relative 'payslip_v3_bank_account_detail'
+require_relative 'payslip_v3_employment'
+require_relative 'payslip_v3_salary_detail'
+require_relative 'payslip_v3_pay_detail'
+require_relative 'payslip_v3_paid_time_off'
+
+module Mindee
+  module Product
+    module FR
+      module Payslip
+        # Payslip API version 3.0 document data.
+        class PayslipV3Document < Mindee::Parsing::Common::Prediction
+          include Mindee::Parsing::Standard
+          # Information about the employee's bank account.
+          # @return [Mindee::Product::FR::Payslip::PayslipV3BankAccountDetail]
+          attr_reader :bank_account_details
+          # Information about the employee.
+          # @return [Mindee::Product::FR::Payslip::PayslipV3Employee]
+          attr_reader :employee
+          # Information about the employer.
+          # @return [Mindee::Product::FR::Payslip::PayslipV3Employer]
+          attr_reader :employer
+          # Information about the employment.
+          # @return [Mindee::Product::FR::Payslip::PayslipV3Employment]
+          attr_reader :employment
+          # Information about paid time off.
+          # @return [Array<Mindee::Product::FR::Payslip::PayslipV3PaidTimeOff>]
+          attr_reader :paid_time_off
+          # Detailed information about the pay.
+          # @return [Mindee::Product::FR::Payslip::PayslipV3PayDetail]
+          attr_reader :pay_detail
+          # Information about the pay period.
+          # @return [Mindee::Product::FR::Payslip::PayslipV3PayPeriod]
+          attr_reader :pay_period
+          # Detailed information about the earnings.
+          # @return [Array<Mindee::Product::FR::Payslip::PayslipV3SalaryDetail>]
+          attr_reader :salary_details
+
+          # @param prediction [Hash]
+          # @param page_id [Integer, nil]
+          def initialize(prediction, page_id)
+            super()
+            @bank_account_details = PayslipV3BankAccountDetail.new(prediction['bank_account_details'], page_id)
+            @employee = PayslipV3Employee.new(prediction['employee'], page_id)
+            @employer = PayslipV3Employer.new(prediction['employer'], page_id)
+            @employment = PayslipV3Employment.new(prediction['employment'], page_id)
+            @paid_time_off = []
+            prediction['paid_time_off'].each do |item|
+              @paid_time_off.push(PayslipV3PaidTimeOff.new(item, page_id))
+            end
+            @pay_detail = PayslipV3PayDetail.new(prediction['pay_detail'], page_id)
+            @pay_period = PayslipV3PayPeriod.new(prediction['pay_period'], page_id)
+            @salary_details = []
+            prediction['salary_details'].each do |item|
+              @salary_details.push(PayslipV3SalaryDetail.new(item, page_id))
+            end
+          end
+
+          # @return [String]
+          def to_s
+            pay_period = @pay_period.to_s
+            employee = @employee.to_s
+            employer = @employer.to_s
+            bank_account_details = @bank_account_details.to_s
+            employment = @employment.to_s
+            salary_details = salary_details_to_s
+            pay_detail = @pay_detail.to_s
+            paid_time_off = paid_time_off_to_s
+            out_str = String.new
+            out_str << "\n:Pay Period:"
+            out_str << pay_period
+            out_str << "\n:Employee:"
+            out_str << employee
+            out_str << "\n:Employer:"
+            out_str << employer
+            out_str << "\n:Bank Account Details:"
+            out_str << bank_account_details
+            out_str << "\n:Employment:"
+            out_str << employment
+            out_str << "\n:Salary Details:"
+            out_str << salary_details
+            out_str << "\n:Pay Detail:"
+            out_str << pay_detail
+            out_str << "\n:Paid Time Off:"
+            out_str << paid_time_off
+            out_str[1..].to_s
+          end
+
+          private
+
+          # @param char [String]
+          # @return [String]
+          def salary_details_separator(char)
+            out_str = String.new
+            out_str << '  '
+            out_str << "+#{char * 14}"
+            out_str << "+#{char * 11}"
+            out_str << "+#{char * 38}"
+            out_str << "+#{char * 8}"
+            out_str << "+#{char * 11}"
+            out_str << '+'
+            out_str
+          end
+
+          # @return [String]
+          def salary_details_to_s
+            return '' if @salary_details.empty?
+
+            line_items = @salary_details.map(&:to_table_line).join("\n#{salary_details_separator('-')}\n  ")
+            out_str = String.new
+            out_str << "\n#{salary_details_separator('-')}"
+            out_str << "\n  |"
+            out_str << ' Amount       |'
+            out_str << ' Base      |'
+            out_str << ' Description                          |'
+            out_str << ' Number |'
+            out_str << ' Rate      |'
+            out_str << "\n#{salary_details_separator('=')}"
+            out_str << "\n  #{line_items}"
+            out_str << "\n#{salary_details_separator('-')}"
+            out_str
+          end
+
+          # @param char [String]
+          # @return [String]
+          def paid_time_off_separator(char)
+            out_str = String.new
+            out_str << '  '
+            out_str << "+#{char * 11}"
+            out_str << "+#{char * 8}"
+            out_str << "+#{char * 13}"
+            out_str << "+#{char * 11}"
+            out_str << "+#{char * 11}"
+            out_str << '+'
+            out_str
+          end
+
+          # @return [String]
+          def paid_time_off_to_s
+            return '' if @paid_time_off.empty?
+
+            line_items = @paid_time_off.map(&:to_table_line).join("\n#{paid_time_off_separator('-')}\n  ")
+            out_str = String.new
+            out_str << "\n#{paid_time_off_separator('-')}"
+            out_str << "\n  |"
+            out_str << ' Accrued   |'
+            out_str << ' Period |'
+            out_str << ' Type        |'
+            out_str << ' Remaining |'
+            out_str << ' Used      |'
+            out_str << "\n#{paid_time_off_separator('=')}"
+            out_str << "\n  #{line_items}"
+            out_str << "\n#{paid_time_off_separator('-')}"
+            out_str
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mindee/product/fr/payslip/payslip_v3_employee.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+require_relative '../../../parsing'
+
+module Mindee
+  module Product
+    module FR
+      module Payslip
+        # Information about the employee.
+        class PayslipV3Employee < Mindee::Parsing::Standard::FeatureField
+          include Mindee::Parsing::Standard
+          # The address of the employee.
+          # @return [String]
+          attr_reader :address
+          # The date of birth of the employee.
+          # @return [String]
+          attr_reader :date_of_birth
+          # The first name of the employee.
+          # @return [String]
+          attr_reader :first_name
+          # The last name of the employee.
+          # @return [String]
+          attr_reader :last_name
+          # The phone number of the employee.
+          # @return [String]
+          attr_reader :phone_number
+          # The registration number of the employee.
+          # @return [String]
+          attr_reader :registration_number
+          # The social security number of the employee.
+          # @return [String]
+          attr_reader :social_security_number
+
+          # @param prediction [Hash]
+          # @param page_id [Integer, nil]
+          def initialize(prediction, page_id)
+            super(prediction, page_id)
+            @address = prediction['address']
+            @date_of_birth = prediction['date_of_birth']
+            @first_name = prediction['first_name']
+            @last_name = prediction['last_name']
+            @phone_number = prediction['phone_number']
+            @registration_number = prediction['registration_number']
+            @social_security_number = prediction['social_security_number']
+            @page_id = page_id
+          end
+
+          # @return [Hash]
+          def printable_values
+            printable = {}
+            printable[:address] = format_for_display(@address)
+            printable[:date_of_birth] = format_for_display(@date_of_birth)
+            printable[:first_name] = format_for_display(@first_name)
+            printable[:last_name] = format_for_display(@last_name)
+            printable[:phone_number] = format_for_display(@phone_number)
+            printable[:registration_number] = format_for_display(@registration_number)
+            printable[:social_security_number] = format_for_display(@social_security_number)
+            printable
+          end
+
+          # @return [String]
+          def to_s
+            printable = printable_values
+            out_str = String.new
+            out_str << "\n  :Address: #{printable[:address]}"
+            out_str << "\n  :Date of Birth: #{printable[:date_of_birth]}"
+            out_str << "\n  :First Name: #{printable[:first_name]}"
+            out_str << "\n  :Last Name: #{printable[:last_name]}"
+            out_str << "\n  :Phone Number: #{printable[:phone_number]}"
+            out_str << "\n  :Registration Number: #{printable[:registration_number]}"
+            out_str << "\n  :Social Security Number: #{printable[:social_security_number]}"
+            out_str
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mindee/product/fr/payslip/payslip_v3_employer.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+require_relative '../../../parsing'
+
+module Mindee
+  module Product
+    module FR
+      module Payslip
+        # Information about the employer.
+        class PayslipV3Employer < Mindee::Parsing::Standard::FeatureField
+          include Mindee::Parsing::Standard
+          # The address of the employer.
+          # @return [String]
+          attr_reader :address
+          # The company ID of the employer.
+          # @return [String]
+          attr_reader :company_id
+          # The site of the company.
+          # @return [String]
+          attr_reader :company_site
+          # The NAF code of the employer.
+          # @return [String]
+          attr_reader :naf_code
+          # The name of the employer.
+          # @return [String]
+          attr_reader :name
+          # The phone number of the employer.
+          # @return [String]
+          attr_reader :phone_number
+          # The URSSAF number of the employer.
+          # @return [String]
+          attr_reader :urssaf_number
+
+          # @param prediction [Hash]
+          # @param page_id [Integer, nil]
+          def initialize(prediction, page_id)
+            super(prediction, page_id)
+            @address = prediction['address']
+            @company_id = prediction['company_id']
+            @company_site = prediction['company_site']
+            @naf_code = prediction['naf_code']
+            @name = prediction['name']
+            @phone_number = prediction['phone_number']
+            @urssaf_number = prediction['urssaf_number']
+            @page_id = page_id
+          end
+
+          # @return [Hash]
+          def printable_values
+            printable = {}
+            printable[:address] = format_for_display(@address)
+            printable[:company_id] = format_for_display(@company_id)
+            printable[:company_site] = format_for_display(@company_site)
+            printable[:naf_code] = format_for_display(@naf_code)
+            printable[:name] = format_for_display(@name)
+            printable[:phone_number] = format_for_display(@phone_number)
+            printable[:urssaf_number] = format_for_display(@urssaf_number)
+            printable
+          end
+
+          # @return [String]
+          def to_s
+            printable = printable_values
+            out_str = String.new
+            out_str << "\n  :Address: #{printable[:address]}"
+            out_str << "\n  :Company ID: #{printable[:company_id]}"
+            out_str << "\n  :Company Site: #{printable[:company_site]}"
+            out_str << "\n  :NAF Code: #{printable[:naf_code]}"
+            out_str << "\n  :Name: #{printable[:name]}"
+            out_str << "\n  :Phone Number: #{printable[:phone_number]}"
+            out_str << "\n  :URSSAF Number: #{printable[:urssaf_number]}"
+            out_str
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mindee/product/fr/payslip/payslip_v3_employment.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+require_relative '../../../parsing'
+
+module Mindee
+  module Product
+    module FR
+      module Payslip
+        # Information about the employment.
+        class PayslipV3Employment < Mindee::Parsing::Standard::FeatureField
+          include Mindee::Parsing::Standard
+          # The category of the employment.
+          # @return [String]
+          attr_reader :category
+          # The coefficient of the employment.
+          # @return [String]
+          attr_reader :coefficient
+          # The collective agreement of the employment.
+          # @return [String]
+          attr_reader :collective_agreement
+          # The job title of the employee.
+          # @return [String]
+          attr_reader :job_title
+          # The position level of the employment.
+          # @return [String]
+          attr_reader :position_level
+          # The seniority date of the employment.
+          # @return [String]
+          attr_reader :seniority_date
+          # The start date of the employment.
+          # @return [String]
+          attr_reader :start_date
+
+          # @param prediction [Hash]
+          # @param page_id [Integer, nil]
+          def initialize(prediction, page_id)
+            super(prediction, page_id)
+            @category = prediction['category']
+            @coefficient = prediction['coefficient']
+            @collective_agreement = prediction['collective_agreement']
+            @job_title = prediction['job_title']
+            @position_level = prediction['position_level']
+            @seniority_date = prediction['seniority_date']
+            @start_date = prediction['start_date']
+            @page_id = page_id
+          end
+
+          # @return [Hash]
+          def printable_values
+            printable = {}
+            printable[:category] = format_for_display(@category)
+            printable[:coefficient] = format_for_display(@coefficient)
+            printable[:collective_agreement] = format_for_display(@collective_agreement)
+            printable[:job_title] = format_for_display(@job_title)
+            printable[:position_level] = format_for_display(@position_level)
+            printable[:seniority_date] = format_for_display(@seniority_date)
+            printable[:start_date] = format_for_display(@start_date)
+            printable
+          end
+
+          # @return [String]
+          def to_s
+            printable = printable_values
+            out_str = String.new
+            out_str << "\n  :Category: #{printable[:category]}"
+            out_str << "\n  :Coefficient: #{printable[:coefficient]}"
+            out_str << "\n  :Collective Agreement: #{printable[:collective_agreement]}"
+            out_str << "\n  :Job Title: #{printable[:job_title]}"
+            out_str << "\n  :Position Level: #{printable[:position_level]}"
+            out_str << "\n  :Seniority Date: #{printable[:seniority_date]}"
+            out_str << "\n  :Start Date: #{printable[:start_date]}"
+            out_str
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mindee/product/fr/payslip/payslip_v3_page.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative '../../../parsing'
+require_relative 'payslip_v3_document'
+
+module Mindee
+  module Product
+    module FR
+      module Payslip
+        # Payslip API version 3.0 page data.
+        class PayslipV3Page < Mindee::Parsing::Common::Page
+          # @param prediction [Hash]
+          def initialize(prediction)
+            super(prediction)
+            @prediction = PayslipV3PagePrediction.new(
+              prediction['prediction'],
+              prediction['id']
+            )
+          end
+        end
+
+        # Payslip V3 page prediction.
+        class PayslipV3PagePrediction < PayslipV3Document
+          # @return [String]
+          def to_s
+            out_str = String.new
+            out_str << "\n#{super}"
+            out_str
+          end
+        end
+      end
+    end
+  end
+end