eco-helpers 2.0.55 → 2.0.58

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a4e49d95179b6066cd2729e64c1db009ed77de653c45a73eaebeab2387ae3bde
-  data.tar.gz: 746f3e6e1f8e17be778ec1c902a71810fa46c6439ea886449f2cf5dc7223d2b4
+  metadata.gz: b6c0a28540154a0421d36734a7b0a7f1d7e52b54082390804f696968b8a24d7c
+  data.tar.gz: 5f046e1b94bca34335551f14d5be2e7082ee91d131200609a8d0d517b0342334
 SHA512:
-  metadata.gz: 88b70189433c7d4c71ea6b549e0eedbadafe9172bd8ea206d83e09f5bade447707f503e92b28f315e720e75743876f8aac480daf0ef5527d4525d17603e00bb2
-  data.tar.gz: d1d513c1c032101ab2aa9af5b1b41a542e99c0cb8312473c0b188698e855cdae965decda09134f01ec57123f2b518438dfe60c3a82265c2d93fdef51495ed0b3
+  metadata.gz: 175e05b1799c9231570b9cd69cd25aafbef5f3db65e48be20c070fef5535d7679c04f032ab885d1cad2ea85fa1191b93d151d903b880821b5d2ad4db482d71ca
+  data.tar.gz: 4fa3671f1519440527d99aa4123aa287642cd8f1e535bba0a0a0201d1a23b15a902d4beca2e5994826746d28fd1b0e3e21fcdb647d3eac462feb067b9434552d

data/CHANGELOG.md

@@ -1,20 +1,68 @@
 # Change Log
 All notable changes to this project will be documented in this file.
 
-## [2.0.55] - 2022-04-xx
+## [2.0.57] - 2022-05-31
 
 ### Added
+  - **Usecase**`Eco::API::UseCases::DefaultCases::ClearAbilitiesTransCase`
+    - invokable with `clear-abilities`
+  - `Eco::API::Session::Config::People` added
+    - `default_login_method` helpers
+  - `Eco::API::Session::Config#default_login_method=` added
+  - `Eco::API::Common::Loaders::Base#abort` method to log an error and raise an exception
+  - **patched** `Ecoportal::API::Internal::Person`
+    - Added a couple of handy helpers: `#replace_doc` and `#replace_original_doc`
+  
 ### Changed
-  - `Eco::API::UseCases::DefaultCases::Samples::Sftp` should move the basename to Windows compatible chars.
+  - `Eco::API::Common::Session::SFTP#move` new parameter `override:` (default: `true`)
+    - If there was an error, it would delete the destination remote file and retry to move the file
+    - upgraded `ecoportal-api-v2` gem to `0.8.28`
+  - `Eco::API::Organization::LoginProviders#login_provider`
+    - Added support to fetch based on type (i.e. password, sso)
+  - `Eco::API::Policies::DefaultPolicies::UserAccess`
+    - Added support for `config.default_login_method`
 
 ### Fixed
+  - `Eco::API::Common::People::EntryFactory`
+    - Max allowed enconding errors was not working (it was just fixing all).
+
+## [2.0.57] - 2022-04-29
+
+### Changed
+  - `Eco::API::UseCases::DefaultCases::HrisCase`
+    - Made it so the `leavers` batch runs first
+    - This aims to prevent some errors such as `cyclic supervisor` or `email already taken`
+
+## [2.0.56] - 2022-04-25
+
+### Added
+  - `Eco::API::UseCases::OozeSamples::OozeBaseCase#add_field_by_doc`
+    - Same as `#add_field` but using an existing _**doc**_ as a model
+
+### Changed
+  - `ecoportal-api-v2` dependency upgrade
+  - `Eco::API::Common::Session::FileManager#file_content`
+    - added parameter `mode:` to options can be used as well
+  - `Eco::API::UseCases::OozeSamples::Helpers::Shortcuts#same_string?`
+    - Added parameter `mild:` to compare the strings with only alphabetic characters
+  - `Eco::API::UseCases::OozeSamples::OozeRunBaseCase`
+    - `#main` and `#process_ooze` methods were not obvious to use
+  - `Eco::API::UseCases::OozeSamples::RegisterUpdateCase` slight change on the **`run` summary message**
+
+### Fixed
+  - `Eco::API::UseCases::OozeSamples::OozeBaseCase#update_ooze`
+    - Added call to `validate` also when we are on `dry-run` **mode**
+
+## [2.0.55] - 2022-04-04
+
+### Fixed
+  - `Eco::API::UseCases::DefaultCases::Samples::Sftp` should move the basename to Windows compatible chars.
 
 ## [2.0.54] - 2022-04-04
 
 ### Added
   - `Eco::API::UseCases::DefaultCases::Samples::Sftp` should tell where the files went in the local.
 
-
 ## [2.0.53] - 2022-04-04
 
 ### Added

data/eco-helpers.gemspec

@@ -31,7 +31,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "redcarpet", ">= 3.5.1",  "< 3.6"
 
   spec.add_dependency 'ecoportal-api', '>= 0.8.5', '< 0.9'
-  spec.add_dependency 'ecoportal-api-v2', '>= 0.8.26', '< 0.9'
+  spec.add_dependency 'ecoportal-api-v2', '>= 0.8.28', '< 0.9'
   spec.add_dependency 'aws-sdk-s3',    '>= 1.83.0', '< 2'
   spec.add_dependency 'aws-sdk-ses',   '>= 1.36.0', '< 2'
   spec.add_dependency 'dotenv',        '>= 2.7.6', '< 2.8'

data/lib/eco/api/common/loaders/base.rb

@@ -51,6 +51,14 @@ module Eco
             session.micro
           end
 
+          def abort(msg, raising: true)
+            logger.error(msg)
+            if raising
+              raise msg
+            else
+              exit(1)
+            end
+          end
         end
       end
     end

data/lib/eco/api/common/people/default_parsers/boolean_parser.rb

@@ -11,7 +11,7 @@ class Eco::API::Common::People::DefaultParsers::BooleanParser < Eco::API::Common
 
   private
 
-  def truthy (value)
+  def truthy(value)
     %w[true y yes x].include?(value.to_s.strip.downcase)
   end
 

data/lib/eco/api/common/people/entry_factory.rb

@@ -208,6 +208,7 @@ module Eco
                   logger.error("There were more than 5 encoding errors in the file '#{file}'.")
                   return content
                 else
+                  tolerance -= 1
                   logger.error("Encoding problem in file '#{file}': '#{replacement}'.")
                   replacement
                 end

data/lib/eco/api/common/session/file_manager.rb

@@ -38,14 +38,14 @@ module Eco
             dir.newest_file(file: filename)
           end
 
-          def file_content(filename)
+          def file_content(filename, mode: nil)
             file = dir.file(filename, should_exist: true)
             if !file
               logger.error("Can't read from file '#{filename}' because it does not exist.")
               return nil
             end
             logger.debug("Reading from file '#{file}'")
-            File.read(file)
+            mode ? File.read(file, mode: mode) : File.read(file)
           end
 
           def load_json(filename)

data/lib/eco/api/common/session/sftp.rb

@@ -56,8 +56,14 @@ module Eco
           end
 
           # @see Net::SFTP::Session#rename
-          def move(fullname_source, fullname_dest, flags=0x0001, &callback)
-            sftp_session.rename!(fullname_source, fullname_dest, flags, &callback)
+          def move(fullname_source, fullname_dest, flags=0x0001, override: true, &callback)
+            begin
+              sftp_session.rename!(fullname_source, fullname_dest, flags, &callback)
+            rescue Net::SFTP::StatusException => e
+              raise unless override
+              sftp_session.remove(fullname_dest)
+              sftp_session.rename!(fullname_source, fullname_dest, flags, &callback)
+            end
           end
 
           # Downloads the files specified to a local folder

data/lib/eco/api/common/version_patches/ecoportal_api/internal_person.rb

@@ -14,6 +14,23 @@ module Ecoportal
           account && !ref_doc["account"]
         end
 
+        # It replaces `doc` by `new_doc`
+        # @return [Hash] `doc` before change
+        def replace_doc!(new_doc)
+          raise UnlinkedModel.new(from: "#{self.class}#replace_doc", key: _key) unless linked?
+          @doc.tap do
+            @doc = new_doc
+          end
+        end
+
+        # It replaces `original_doc` by `new_doc`
+        # @return [Hash] `original_doc` before change
+        def replace_original_doc!(new_doc)
+          raise UnlinkedModel.new(from: "#{self.class}#replace_original_doc", key: _key) unless linked?
+          @original_doc.tap do
+            @original_doc = new_doc
+          end
+        end
       end
     end
   end

data/lib/eco/api/microcases/set_supervisor.rb

@@ -3,7 +3,7 @@ module Eco
     class MicroCases
       # Unique access point to set the `supervisor_id` value on a person.
       # @note
-      #   - It prevents the basic cyclic supervisor case (supervisor to be supervisor of hemselves)
+      #   - It prevents the basic cyclic supervisor case (supervisor to be supervisor of themselves)
       # @param person [Ecoportal::API::V1::Person] the person we want to update, carrying the changes to be done.
       # @param sup_id [nil, String] the **supervisor id** we should set on the `person`.
       # @param people [Eco::API::Organization::People] _People_ involved in the current update.

data/lib/eco/api/organization/login_providers.rb

@@ -56,27 +56,41 @@ module Eco
           end
         end
 
-        def login_provider(id_name)
-          @by_id.fetch(login_provider_id(id_name), nil)
+        # @param id_name_type [String, Symbol]
+        #   - `String` to refer to the login provider `name` or `id`
+        #   - `Symbol` to refer to the login providr type (i.e. `:password`, `:sso`)
+        def login_provider(id_name_type)
+          @by_id[login_provider_id(id_name_type)]
         end
 
         private
 
-        def login_provider_name(id_name)
-          (@by_id[id_name] || @by_name[id_name&.downcase])&.name&.downcase
-        end
-
-        def login_provider_id(id_name)
-          (@by_name[id_name&.downcase] || @by_id[id_name])&.id
+        def login_provider_id(value)
+          case value
+          when Symbol
+            value = value.to_s.downcase.to_sym
+            @by_type[value]&.id
+          when String
+            value = value.strip.downcase
+            @by_name[value]&.id || @by_id[value]&.id
+          end
         end
 
         def init_caches
           return if @caches_init
-          @by_id   = self.map { |pg| [pg.id, pg] }.to_h
-          @by_name = self.map { |pg| [pg.name&.downcase, pg] }.to_h
+          enabled_lps = self.select {|lp| lp.enabled_for != "disabled"}
+          @by_id   = enabled_lps.each_with_object({}) do |lp, hash|
+            hash[lp.id.downcase] = lp
+          end
+          @by_name = enabled_lps.each_with_object({}) do |lp, hash|
+            hash[lp.name.downcase] = lp
+          end
+          @by_type = enabled_lps.each_with_object({}) do |lp, hash|
+            hash[lp.type.downcase.to_sym] = lp
+            hash[:sso] = lp if (!hash.key?(:sso) && lp.type == "saml")
+          end
           @caches_init = true
         end
-
       end
     end
   end

data/lib/eco/api/policies/default_policies/99_user_access_policy.rb

@@ -1,3 +1,7 @@
+# Default policy:
+# 1. Removes the account if the email is empty
+# 2. Adds the defined default_usergroup if user does not have policy groups
+# 3. Adds the defined default_login_method if update includes empty login methods
 class Eco::API::Policies::DefaultPolicies::UserAccess < Eco::API::Common::Loaders::Policy
   name "default-user-access"
 
@@ -10,8 +14,12 @@ class Eco::API::Policies::DefaultPolicies::UserAccess < Eco::API::Common::Loader
     self.account_removed_count = 0
 
     people.each do |person|
-      remove_account_when_no_email!(person)    if person.email.to_s.empty?
-      person.account.policy_group_ids = defid  if no_policy_group_ids?(person)
+      remove_account_when_no_email!(person) if person.email.to_s.empty?
+      next unless account = person.account
+      if account.policy_group_ids.empty? && def_pg
+        account.policy_group_ids = [def_pg]
+      end
+      add_login_method_if_applicable!(account)
     end
 
     warn_account_removal!
@@ -39,20 +47,34 @@ class Eco::API::Policies::DefaultPolicies::UserAccess < Eco::API::Common::Loader
     return !!person.original_doc["account"]
   end
 
-  def no_policy_group_ids?(person)
-    (account = person.account) &&  account.policy_group_ids.empty?
+  def add_login_method_if_applicable!(account)
+    return unless account.as_update.key?("login_provider_ids")
+    if account.login_provider_ids.empty? && def_login
+      account.login_provider_ids = [def_login]
+    end
+  end
+
+  def def_pg
+    @def_pg ||= policy_groups.to_id(default_group)
   end
 
-  def defid
-    @defid ||= policy_groups.to_id([default_group]).compact
+  def def_login
+    @def_login ||= login_providers.to_id(default_login)
   end
 
   def default_group
-    session.config.people.default_usergroup
+    config.people.default_usergroup
+  end
+
+  def default_login
+    config.people.default_login_method
+  end
+
+  def login_providers
+    session.login_providers
   end
 
   def policy_groups
     session.policy_groups
   end
-
 end

data/lib/eco/api/session/config/people.rb

@@ -86,7 +86,19 @@ module Eco
           def default_schema?
             !!self["default_schema"]
           end
-          
+
+          def default_login_method=(name)
+            self["default_login_method"] = name
+          end
+
+          def default_login_method
+            self["default_login_method"]
+          end
+
+          def default_login_method?
+            !!self["default_login_method"]
+          end
+
           # @return [Hash] with defined pairs format `key` and Person parsers.
           def parsers
             self["parsers"] ||= {}

data/lib/eco/api/session/config.rb

@@ -297,6 +297,11 @@ module Eco
           people.default_schema = name
         end
 
+        # Set the **default login method** that users should acquire.
+        def default_login_method=(name)
+          people.default_login_method = name
+        end
+
         # @see Eco::API::Session::Config::People
         # @param (see Eco::API::Session::Config::People)
         # @return [Eco::API::Common::People::PersonParser] parser/serializer for the defined `format`.

data/lib/eco/api/usecases/default_cases/clear_abilities_case.rb

@@ -0,0 +1,22 @@
+class Eco::API::UseCases::DefaultCases::ClearAbilitiesTransCase < Eco::API::Common::Loaders::UseCase
+  name "clear-abilities"
+  type :transform
+
+  def main(people, session, options, usecase)
+    clear_abilities(people.users, session, options, usecase)
+  end
+
+  private
+
+  def clear_abilities(users, session, options, usecase)
+    update   = session.new_job("main", "clear-abilities", :update, usecase, :account)
+    users.each do |person|
+      person.account.permissions_custom = nil_abilities.dup
+      update.add(person)
+    end
+  end
+
+  def nil_abilities
+    @nil_abilities ||= Eco::API::Organization::PresetsFactory.all_abilities
+  end
+end

data/lib/eco/api/usecases/default_cases/hris_case.rb

@@ -9,10 +9,10 @@ class Eco::API::UseCases::DefaultCases::HrisCase < Eco::API::Common::Loaders::Us
     @session = session; @options = options; @people = people
     require_only_one_schema!
     micro    = session.micro
+    @leavers  = session.new_job("pre", "leavers",  :update, usecase, :account)
     @creation = session.new_job("main", "create",  :create, usecase)
     @update   = session.new_job("main", "update",  :update, usecase)
     @supers   = session.new_job("post", "supers",  :update, usecase, :core)
-    @leavers  = session.new_job("post", "leavers", :update, usecase, :account)
 
     micro.with_each_leaver(entries, people, options) do |person|
       leavers.add(person, &method(:leavers_callback))

data/lib/eco/api/usecases/default_cases.rb

@@ -15,6 +15,7 @@ require_relative 'default_cases/analyse_people_case'
 require_relative 'default_cases/append_usergroups_case'
 require_relative 'default_cases/change_email_case'
 require_relative 'default_cases/clean_unknown_tags_case'
+require_relative 'default_cases/clear_abilities_case'
 require_relative 'default_cases/codes_to_tags_case'
 require_relative 'default_cases/create_case'
 require_relative 'default_cases/create_details_case'

data/lib/eco/api/usecases/ooze_samples/helpers/shortcuts.rb

@@ -6,13 +6,20 @@ module Eco
           module Shortcuts
 
             # Offers multiple ways to compare two strings
-            def same_string?(value1, value2, exact: false)
+            def same_string?(value1, value2, exact: false, mild: false)
               case
               when value1.is_a?(String) && value2.is_a?(String)
                 if exact
                   value1 == value2
                 else
-                  value1.to_s.strip.downcase == value2.to_s.strip.downcase
+                  v1 = value1.to_s.strip.downcase
+                  v2 = value2.to_s.strip.downcase
+
+                  if mild
+                    v1 = v1.gsub(/[^a-z ]+/, ' ').gsub(/\s+/, ' ').strip
+                    v2 = v2.gsub(/[^a-z ]+/, ' ').gsub(/\s+/, ' ').strip
+                  end
+                  v1 == v2
                 end
               when value1.is_a?(Regexp) && value2.is_a?(String)
                 value2 =~ value1
@@ -64,11 +71,31 @@ module Eco
                   ref << "Page (#{obj.id}) (#{object_reference(obj.current_stage)})"
                 when Ecoportal::API::V2::Page
                   ref << "Page"
+                when Ecoportal::API::V2::Page::Section
+                  ref << "Section '#{obj.heading || "(unnamed)"}'"
+                when Ecoportal::API::V2::Page::Component
+                  ref << "Component '#{obj.label || "(unnamed of type '#{obj.type}')"}' in #{object_reference(obj.section)}"
+                when Ecoportal::API::V2::Page::Force
+                  ref << "Force '#{obj.name}'"
+                when Ecoportal::API::V2::Page::Force::Binding
+                  ref << "Binding '#{obj.name}' in #{object_reference(obj.force)}"
                 end
                 ref << " '#{obj.name}'" if obj.respond_to?(:name)
               end
             end
 
+            def to_i
+              Float(value).to_i
+            end
+
+            # https://stackoverflow.com/a/5661695/4352306
+            def is_number?(value)
+              begin
+                true if Float(value)
+              rescue ArgumentError => e
+                false
+              end
+            end
           end
         end
       end

data/lib/eco/api/usecases/ooze_samples/ooze_base_case.rb

@@ -29,7 +29,18 @@ class Eco::API::UseCases::OozeSamples::OozeBaseCase < Eco::API::Common::Loaders:
 
   protected
 
-  def add_field(name, type, section, after:  nil, before: nil, side: :left)
+  def add_field_by_doc(doc, section, after: nil, before: nil, side: :left)
+    unless section.is_a?(Ecoportal::API::V2::Page::Section)
+      raise "You need to specify a section for a new field. Given: #{section.class}"
+    end
+    target.components.add(doc: doc) do |field|
+      section.add_component(field, after: after, before: before, side: side)
+    end.tap do |field|
+      yield(field) if block_given?
+    end
+  end
+
+  def add_field(name, type, section, after: nil, before: nil, side: :left)
     unless section.is_a?(Ecoportal::API::V2::Page::Section)
       raise "You need to specify a section for a new field. Given: #{section.class}"
     end
@@ -92,7 +103,7 @@ class Eco::API::UseCases::OozeSamples::OozeBaseCase < Eco::API::Common::Loaders:
     if ooze_id = ooze && ooze.id
       exit_error "#{object_reference(ooze)} does not have stages!" unless ooze.stages?
     else
-      exit_error "There's no target ooze to get retrieve stages from"
+      exit_error "There's no target ooze to retrieve stages from"
     end
 
     if stg = ooze.stages[id_name] || ooze.stages.get_by_name(id_name)
@@ -129,11 +140,15 @@ class Eco::API::UseCases::OozeSamples::OozeBaseCase < Eco::API::Common::Loaders:
         end
       end
     else
+      ooze.validate.tap do |validation|
+        logger.error(validation) if validation.is_a?(String)
+      end
       unless options.dig(:feedback, :only_stats)
         if patch = (patch_doc(ooze) || {})["page"]
           pp patch
         end
       end
+
       backup_patch!(ooze)
       exit(0) if dirty?(ooze) && dry_count > DRY_COUNT
       false
@@ -189,6 +204,4 @@ class Eco::API::UseCases::OozeSamples::OozeBaseCase < Eco::API::Common::Loaders:
     logger.error(msg)
     exit(1)
   end
-
-
 end

data/lib/eco/api/usecases/ooze_samples/ooze_run_base_case.rb

@@ -3,24 +3,26 @@ class Eco::API::UseCases::OozeSamples::OozeRunBaseCase < Eco::API::UseCases::Ooz
   name "ooze-run-base"
   type :other
 
-  attr_reader :session, :options, :usecase
-
   SAVE_PATCH = "ooze_patch_update.json"
 
-  def main(session, options, usecase, &block)
-    raise "You need to inherit from this class and call super with a block" unless block
-    @session = session; @options = options; @usecase = usecase
-    process_ooze(&block)
-  end
-
-  def process_ooze(ooze = target)
-    raise "You need to inherit from this class and call super with a block" unless block_given?
-    super(ooze) do
-      yield(ooze)
+  def main(session, options, usecase)
+    super(session, options, usecase) do
+      if method(:process_ooze).parameters.count == 0
+        ooze # retrieve ooze
+        process_ooze
+      else
+        process_ooze(ooze)
+      end
+      yield(target) if block_given?
       exit_if_no_changes!
+      update_ooze(target)
     end
   end
 
+  def process_ooze(page = target)
+    raise "You need to redefine this method"
+  end
+
   private
 
   def ooze

data/lib/eco/api/usecases/ooze_samples/register_update_case.rb

@@ -39,7 +39,8 @@ class Eco::API::UseCases::OozeSamples::RegisterUpdateCase < Eco::API::UseCases::
     msg += "  • Duplicated search results #{dupped_search_oozes}\n"
     msg += "  • Retrieved a total of #{retrieved_oozes}\n"
     msg += "  • Could not get #{non_retrieved_oozes} oozes.\n"
-    msg += "  • Updated #{updated_oozes} oozes (failed update on #{failed_update_oozes} oozes).\n"
+    msg += "  • Updated #{updated_oozes} oozes.\n"
+    msg += "    - Failed update on #{failed_update_oozes} oozes.\n"
     logger.info(msg)
   end
 
@@ -72,7 +73,6 @@ class Eco::API::UseCases::OozeSamples::RegisterUpdateCase < Eco::API::UseCases::
         end
 
         if pending = queue_shift(page_result.id)
-
           if dirty?(pending)
             msg  = "Inconsistent search results. "
             msg << "Launching update on '#{object_reference(pending)}' to be able to queue it back"

data/lib/eco/cli/config/default/usecases.rb

@@ -196,6 +196,10 @@ ASSETS.cli.config do |cnf|
       options.deep_merge!(force: {invite: true})
     end
 
+    desc  = "Clears the `permissions_custom`, provided that Policy Group abilities alone apply."
+    desc += " Please be mindfull if you use this option (there may be users that have been upgraded in ad-hoc manner)."
+    cases.add("-clear-abilities", :transform, desc, case_name: "clear-abilities")
+
     desc = "Deletes everybody that has been filtered from the people manager"
     cases.add("-delete", :transform, desc, case_name: "delete")
     desc = "Deletes the people specified in the input data"

data/lib/eco/version.rb

@@ -1,3 +1,3 @@
 module Eco
-  VERSION = "2.0.55"
+  VERSION = "2.0.58"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: eco-helpers
 version: !ruby/object:Gem::Version
-  version: 2.0.55
+  version: 2.0.58
 platform: ruby
 authors:
 - Oscar Segura
@@ -136,7 +136,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.8.26
+        version: 0.8.28
     - - "<"
       - !ruby/object:Gem::Version
         version: '0.9'
@@ -146,7 +146,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.8.26
+        version: 0.8.28
     - - "<"
       - !ruby/object:Gem::Version
         version: '0.9'
@@ -528,6 +528,7 @@ files:
 - lib/eco/api/usecases/default_cases/append_usergroups_case.rb
 - lib/eco/api/usecases/default_cases/change_email_case.rb
 - lib/eco/api/usecases/default_cases/clean_unknown_tags_case.rb
+- lib/eco/api/usecases/default_cases/clear_abilities_case.rb
 - lib/eco/api/usecases/default_cases/codes_to_tags_case.rb
 - lib/eco/api/usecases/default_cases/create_case.rb
 - lib/eco/api/usecases/default_cases/create_details_case.rb