servactory 2.16.1 → 3.0.0.rc2

data/config/locales/it.yml

@@ -0,0 +1,134 @@
+it:
+  servactory:
+    common:
+      undefined_method:
+        missing_name: "[%{service_class_name}] %{error_text}"
+    methods:
+      call:
+        not_used: "[%{service_class_name}] Niente da eseguire. Usa `make` o crea un metodo `call`."
+      cannot_be_overwritten: "[%{service_class_name}] I seguenti metodi non possono essere sovrascritti: %{list_of_methods}"
+    inputs:
+      undefined:
+        for_fetch: "[%{service_class_name}] Attributo di input non definito `%{input_name}`"
+        for_assign: "[%{service_class_name}] Attributo di input non definito `%{input_name}`"
+      validations:
+        must:
+          default_error: "[%{service_class_name}] L'input `%{input_name}` deve \"%{code}\""
+          syntax_error: "[%{service_class_name}] Errore di sintassi in `%{code}` dell'input `%{input_name}`: %{exception_message}"
+          dynamic_options:
+            consists_of:
+              required: "[%{service_class_name}] Elemento richiesto mancante nella collezione di input `%{input_name}`"
+              wrong_type: "[%{service_class_name}] Tipo di collezione di input errato `%{input_name}`, previsto `%{expected_type}`, ricevuto `%{given_type}`"
+              wrong_element_type: "[%{service_class_name}] Tipo di elemento errato nella collezione di input `%{input_name}`, previsto `%{expected_type}`, ricevuto `%{given_type}`"
+            format:
+              default: "[%{service_class_name}] L'input `%{input_name}` non corrisponde al formato `%{format_name}`"
+              wrong_pattern: "[%{service_class_name}] L'input `%{input_name}` non corrisponde al formato `%{format_name}`"
+              wrong_type: "[%{service_class_name}] L'input `%{input_name}` deve essere una stringa per la validazione del formato `%{format_name}`"
+              unknown: "[%{service_class_name}] Formato sconosciuto `%{format_name}` specificato per l'input `%{input_name}`"
+            inclusion:
+              default: "[%{service_class_name}] Valore errato in `%{input_name}`, deve essere uno di `%{input_inclusion}`, ricevuto `%{value}`"
+              invalid_option: "[%{service_class_name}] L'input `%{input_name}` ha valore mancante nell'opzione `%{option_name}`"
+            min:
+              default: "[%{service_class_name}] L'input `%{input_name}` ha ricevuto il valore `%{value}`, che è inferiore a `%{option_value}`"
+            max:
+              default: "[%{service_class_name}] L'input `%{input_name}` ha ricevuto il valore `%{value}`, che è superiore a `%{option_value}`"
+            multiple_of:
+              default: "[%{service_class_name}] L'input `%{input_name}` ha il valore `%{value}`, che non è un multiplo di `%{option_value}`"
+              blank: "[%{service_class_name}] L'input `%{input_name}` ha un valore non valido `%{option_value}` nell'opzione `%{option_name}`"
+              divided_by_0: "[%{service_class_name}] L'input `%{input_name}` ha un valore non valido `%{option_value}` nell'opzione `%{option_name}`"
+            schema:
+              wrong_type: "[%{service_class_name}] Tipo errato dell'input `%{input_name}`, previsto `%{expected_type}`, ricevuto `%{given_type}`"
+              wrong_element_type: "[%{service_class_name}] Tipo errato nell'hash di input `%{input_name}`, per `%{key_name}` previsto `%{expected_type}`, ricevuto `%{given_type}`"
+              wrong_element_value: "[%{service_class_name}] Valore errato nell'hash di input `%{input_name}`, per `%{key_name}` valore previsto di tipo `%{expected_type}`, ricevuto `%{given_type}`"
+            target:
+              default: "[%{service_class_name}] L'input `%{input_name}` ha obiettivo errato, deve essere `%{expected_target}`, ricevuto `%{value}`"
+              invalid_option: "[%{service_class_name}] L'input `%{input_name}` ha valore mancante nell'opzione `%{option_name}`"
+        required:
+          default_error:
+            default: "[%{service_class_name}] L'input richiesto `%{input_name}` è mancante"
+        type:
+          default_error:
+            default: "[%{service_class_name}] Tipo errato dell'input `%{input_name}`, previsto `%{expected_type}`, ricevuto `%{given_type}`"
+      tools:
+        find_unnecessary:
+          error: "[%{service_class_name}] Attributi inattesi: `%{unnecessary_attributes}`"
+        rules:
+          error: "[%{service_class_name}] Conflitto nelle opzioni dell'input `%{input_name}`: `%{conflict_code}`"
+    internals:
+      undefined:
+        for_fetch: "[%{service_class_name}] Attributo interno non definito `%{internal_name}`"
+        for_assign: "[%{service_class_name}] Attributo interno non definito `%{internal_name}`"
+      validations:
+        must:
+          default_error: "[%{service_class_name}] L'attributo interno `%{internal_name}` deve \"%{code}\""
+          syntax_error: "[%{service_class_name}] Errore di sintassi in `%{code}` dell'attributo interno `%{internal_name}`: %{exception_message}"
+          dynamic_options:
+            consists_of:
+              required: "[%{service_class_name}] Elemento richiesto mancante nella collezione dell'attributo interno `%{internal_name}`"
+              wrong_type: "[%{service_class_name}] Tipo di collezione errato dell'attributo interno `%{internal_name}`, previsto `%{expected_type}`, ricevuto `%{given_type}`"
+              wrong_element_type: "[%{service_class_name}] Tipo di elemento errato nella collezione dell'attributo interno `%{internal_name}`, previsto `%{expected_type}`, ricevuto `%{given_type}`"
+            format:
+              default: "[%{service_class_name}] L'attributo interno `%{internal_name}` non corrisponde al formato `%{format_name}`"
+              wrong_pattern: "[%{service_class_name}] L'attributo interno `%{internal_name}` non corrisponde al formato `%{format_name}`"
+              wrong_type: "[%{service_class_name}] L'attributo interno `%{internal_name}` deve essere una stringa per la validazione del formato `%{format_name}`"
+              unknown: "[%{service_class_name}] Formato sconosciuto `%{format_name}` specificato per l'attributo interno `%{internal_name}`"
+            inclusion:
+              default: "[%{service_class_name}] Valore errato in `%{internal_name}`, deve essere uno di `%{internal_inclusion}`, ricevuto `%{value}`"
+              invalid_option: "[%{service_class_name}] L'attributo interno `%{internal_name}` ha valore mancante nell'opzione `%{option_name}`"
+            min:
+              default: "[%{service_class_name}] L'attributo interno `%{internal_name}` ha ricevuto il valore `%{value}`, che è inferiore a `%{option_value}`"
+            max:
+              default: "[%{service_class_name}] L'attributo interno `%{internal_name}` ha ricevuto il valore `%{value}`, che è superiore a `%{option_value}`"
+            multiple_of:
+              default: "[%{service_class_name}] L'attributo interno `%{internal_name}` ha il valore `%{value}`, che non è un multiplo di `%{option_value}`"
+              blank: "[%{service_class_name}] L'attributo interno `%{internal_name}` ha un valore non valido `%{option_value}` nell'opzione `%{option_name}`"
+              divided_by_0: "[%{service_class_name}] L'attributo interno `%{internal_name}` ha un valore non valido `%{option_value}` nell'opzione `%{option_name}`"
+            schema:
+              wrong_type: "[%{service_class_name}] Tipo errato dell'attributo interno `%{internal_name}`, previsto `%{expected_type}`, ricevuto `%{given_type}`"
+              wrong_element_type: "[%{service_class_name}] Tipo errato nell'hash dell'attributo interno `%{internal_name}`, per `%{key_name}` previsto `%{expected_type}`, ricevuto `%{given_type}`"
+              wrong_element_value: "[%{service_class_name}] Valore errato nell'hash dell'attributo interno `%{internal_name}`, per `%{key_name}` valore previsto di tipo `%{expected_type}`, ricevuto `%{given_type}`"
+            target:
+              default: "[%{service_class_name}] L'attributo interno `%{internal_name}` ha obiettivo errato, deve essere `%{expected_target}`, ricevuto `%{value}`"
+              invalid_option: "[%{service_class_name}] L'attributo interno `%{internal_name}` ha valore mancante nell'opzione `%{option_name}`"
+        type:
+          default_error:
+            default: "[%{service_class_name}] Tipo errato dell'attributo interno `%{internal_name}`, previsto `%{expected_type}`, ricevuto `%{given_type}`"
+    outputs:
+      undefined:
+        for_fetch: "[%{service_class_name}] Attributo di output non definito `%{output_name}`"
+        for_assign: "[%{service_class_name}] Attributo di output non definito `%{output_name}`"
+      validations:
+        must:
+          default_error: "[%{service_class_name}] L'attributo di output `%{output_name}` deve \"%{code}\""
+          syntax_error: "[%{service_class_name}] Errore di sintassi in `%{code}` dell'attributo di output `%{output_name}`: %{exception_message}"
+          dynamic_options:
+            consists_of:
+              required: "[%{service_class_name}] Elemento richiesto mancante nella collezione dell'attributo di output `%{output_name}`"
+              wrong_type: "[%{service_class_name}] Tipo di collezione errato dell'attributo di output `%{output_name}`, previsto `%{expected_type}`, ricevuto `%{given_type}`"
+              wrong_element_type: "[%{service_class_name}] Tipo di elemento errato nella collezione dell'attributo di output `%{output_name}`, previsto `%{expected_type}`, ricevuto `%{given_type}`"
+            format:
+              default: "[%{service_class_name}] L'attributo di output `%{output_name}` non corrisponde al formato `%{format_name}`"
+              wrong_pattern: "[%{service_class_name}] L'attributo di output `%{output_name}` non corrisponde al formato `%{format_name}`"
+              wrong_type: "[%{service_class_name}] L'attributo di output `%{output_name}` deve essere una stringa per la validazione del formato `%{format_name}`"
+              unknown: "[%{service_class_name}] Formato sconosciuto `%{format_name}` specificato per l'attributo di output `%{output_name}`"
+            inclusion:
+              default: "[%{service_class_name}] Valore errato in `%{output_name}`, deve essere uno di `%{output_inclusion}`, ricevuto `%{value}`"
+              invalid_option: "[%{service_class_name}] L'attributo di output `%{output_name}` ha valore mancante nell'opzione `%{option_name}`"
+            min:
+              default: "[%{service_class_name}] L'attributo di output `%{output_name}` ha ricevuto il valore `%{value}`, che è inferiore a `%{option_value}`"
+            max:
+              default: "[%{service_class_name}] L'attributo di output `%{output_name}` ha ricevuto il valore `%{value}`, che è superiore a `%{option_value}`"
+            multiple_of:
+              default: "[%{service_class_name}] L'attributo di output `%{output_name}` ha il valore `%{value}`, che non è un multiplo di `%{option_value}`"
+              blank: "[%{service_class_name}] L'attributo di output `%{output_name}` ha un valore non valido `%{option_value}` nell'opzione `%{option_name}`"
+              divided_by_0: "[%{service_class_name}] L'attributo di output `%{output_name}` ha un valore non valido `%{option_value}` nell'opzione `%{option_name}`"
+            schema:
+              wrong_type: "[%{service_class_name}] Tipo errato dell'attributo di output `%{output_name}`, previsto `%{expected_type}`, ricevuto `%{given_type}`"
+              wrong_element_type: "[%{service_class_name}] Tipo errato nell'hash dell'attributo di output `%{output_name}`, per `%{key_name}` previsto `%{expected_type}`, ricevuto `%{given_type}`"
+              wrong_element_value: "[%{service_class_name}] Valore errato nell'hash dell'attributo di output `%{output_name}`, per `%{key_name}` valore previsto di tipo `%{expected_type}`, ricevuto `%{given_type}`"
+            target:
+              default: "[%{service_class_name}] L'attributo di output `%{output_name}` ha obiettivo errato, deve essere `%{expected_target}`, ricevuto `%{value}`"
+              invalid_option: "[%{service_class_name}] L'attributo di output `%{output_name}` ha valore mancante nell'opzione `%{option_name}`"
+        type:
+          default_error:
+            default: "[%{service_class_name}] Tipo errato dell'attributo di output `%{output_name}`, previsto `%{expected_type}`, ricevuto `%{given_type}`"

data/config/locales/ru.yml

@@ -23,9 +23,11 @@ ru:
             format:
               default: "[%{service_class_name}] Инпут `%{input_name}` не соответствует формату `%{format_name}`"
               wrong_pattern: "[%{service_class_name}] Инпут `%{input_name}` не соответствует формату `%{format_name}`"
+              wrong_type: "[%{service_class_name}] Инпут `%{input_name}` должен быть строкой для валидации формата `%{format_name}`"
               unknown: "[%{service_class_name}] Указан неизвестный формат `%{format_name}` у инпута `%{input_name}`"
             inclusion:
               default: "[%{service_class_name}] Неправильное значение в `%{input_name}`, должно быть одним из `%{input_inclusion}`, получено `%{value}`"
+              invalid_option: "[%{service_class_name}] Инпут `%{input_name}` имеет незаполненное значение в опции `%{option_name}`"
             min:
               default: "[%{service_class_name}] Инпут `%{input_name}` получил значение `%{value}`, которое меньше `%{option_value}`"
             max:
@@ -38,6 +40,9 @@ ru:
               wrong_type: "[%{service_class_name}] Неправильный тип инпута `%{input_name}`, ожидалось `%{expected_type}`, получено `%{given_type}`"
               wrong_element_type: "[%{service_class_name}] Неправильный тип в хеше инпута `%{input_name}`, для `%{key_name}` ожидалось `%{expected_type}`, получено `%{given_type}`"
               wrong_element_value: "[%{service_class_name}] Неправильное значение в хеше инпута `%{input_name}`, для `%{key_name}` ожидалось значение с типом `%{expected_type}`, получено `%{given_type}`"
+            target:
+              default: "[%{service_class_name}] Инпут `%{input_name}` имеет неправильное значение, должно быть `%{expected_target}`, получено `%{value}`"
+              invalid_option: "[%{service_class_name}] Инпут `%{input_name}` имеет незаполненное значение в опции `%{option_name}`"
         required:
           default_error:
             default: "[%{service_class_name}] Обязательный инпут `%{input_name}` отсутствует"
@@ -65,9 +70,11 @@ ru:
             format:
               default: "[%{service_class_name}] Внутренний атрибут `%{internal_name}` не соответствует формату `%{format_name}`"
               wrong_pattern: "[%{service_class_name}] Внутренний атрибут `%{internal_name}` не соответствует формату `%{format_name}`"
+              wrong_type: "[%{service_class_name}] Внутренний атрибут `%{internal_name}` должен быть строкой для валидации формата `%{format_name}`"
               unknown: "[%{service_class_name}] Указан неизвестный формат `%{format_name}` у внутреннего атрибута `%{internal_name}`"
             inclusion:
               default: "[%{service_class_name}] Неправильное значение в `%{internal_name}`, должно быть одним из `%{internal_inclusion}`, получено `%{value}`"
+              invalid_option: "[%{service_class_name}] Внутренний атрибут `%{internal_name}` имеет незаполненное значение в опции `%{option_name}`"
             min:
               default: "[%{service_class_name}] Внутренний атрибут `%{internal_name}` получил значение `%{value}`, которое меньше `%{option_value}`"
             max:
@@ -80,6 +87,9 @@ ru:
               wrong_type: "[%{service_class_name}] Неправильный тип внутреннего атрибута `%{internal_name}`, ожидалось `%{expected_type}`, получено `%{given_type}`"
               wrong_element_type: "[%{service_class_name}] Неправильный тип в хеше внутреннего атрибута `%{internal_name}`, для `%{key_name}` ожидалось `%{expected_type}`, получено `%{given_type}`"
               wrong_element_value: "[%{service_class_name}] Неправильное значение в хеше внутреннего атрибута `%{internal_name}`, для `%{key_name}` ожидалось значение с типом `%{expected_type}`, получено `%{given_type}`"
+            target:
+              default: "[%{service_class_name}] Внутренний атрибут `%{internal_name}` имеет неправильное значение, должно быть `%{expected_target}`, получено `%{value}`"
+              invalid_option: "[%{service_class_name}] Внутренний атрибут `%{internal_name}` имеет незаполненное значение в опции `%{option_name}`"
         type:
           default_error:
             default: "[%{service_class_name}] Неправильный тип внутреннего атрибута `%{internal_name}`, ожидалось `%{expected_type}`, получено `%{given_type}`"
@@ -99,9 +109,11 @@ ru:
             format:
               default: "[%{service_class_name}] Выходящий атрибут `%{output_name}` не соответствует формату `%{format_name}`"
               wrong_pattern: "[%{service_class_name}] Выходящий атрибут `%{output_name}` не соответствует формату `%{format_name}`"
+              wrong_type: "[%{service_class_name}] Выходящий атрибут `%{output_name}` должен быть строкой для валидации формата `%{format_name}`"
               unknown: "[%{service_class_name}] Указан неизвестный формат `%{format_name}` у выходящего атрибута `%{output_name}`"
             inclusion:
               default: "[%{service_class_name}] Неправильное значение в `%{output_name}`, должно быть одним из `%{output_inclusion}`, получено `%{value}`"
+              invalid_option: "[%{service_class_name}] Выходящий атрибут `%{output_name}` имеет незаполненное значение в опции `%{option_name}`"
             min:
               default: "[%{service_class_name}] Выходящий атрибут `%{output_name}` получил значение `%{value}`, которое меньше `%{option_value}`"
             max:
@@ -114,6 +126,9 @@ ru:
               wrong_type: "[%{service_class_name}] Неправильный тип выходящего атрибута `%{output_name}`, ожидалось `%{expected_type}`, получено `%{given_type}`"
               wrong_element_type: "[%{service_class_name}] Неправильный тип в хеше выходящего атрибута `%{output_name}`, для `%{key_name}` ожидалось `%{expected_type}`, получено `%{given_type}`"
               wrong_element_value: "[%{service_class_name}] Неправильное значение в хеше выходящего атрибута `%{output_name}`, для `%{key_name}` ожидалось значение с типом `%{expected_type}`, получено `%{given_type}`"
+            target:
+              default: "[%{service_class_name}] Выходящий атрибут `%{output_name}` имеет неправильное значение, должно быть `%{expected_target}`, получено `%{value}`"
+              invalid_option: "[%{service_class_name}] Выходящий атрибут `%{output_name}` имеет незаполненное значение в опции `%{option_name}`"
         type:
           default_error:
             default: "[%{service_class_name}] Неправильный тип выходящего атрибута `%{output_name}`, ожидалось `%{expected_type}`, получено `%{given_type}`"

data/lib/generators/README.md

@@ -0,0 +1,45 @@
+# Servactory Generators
+
+## Installation
+
+```bash
+rails generate servactory:install [options]
+```
+
+**Options:**
+- `--namespace` — Base namespace (default: `ApplicationService`)
+- `--path` — Path to install service files (default: `app/services`)
+- `--locales` — Locales to install (available: `en`, `ru`, `de`, `fr`, `es`, `it`)
+- `--minimal` — Generate minimal setup without configuration examples
+
+## Service
+
+```bash
+rails generate servactory:service NAME [inputs] [options]
+```
+
+**Arguments:**
+- `NAME` — Service name (e.g., `Users::Create`, `ProcessOrder`)
+- `inputs` — Input attributes with optional types (e.g., `email:string name:String user:User`)
+
+**Options:**
+- `--base-class` — Base class for service (default: `ApplicationService::Base`)
+- `--path` — Path to generate service files (default: `app/services`)
+- `--skip-output` — Skip default output declaration
+
+## RSpec
+
+```bash
+rails generate servactory:rspec NAME [inputs] [options]
+```
+
+Generates RSpec spec for a Servactory service.
+
+**Arguments:**
+- `NAME` — Service name (e.g., `Users::Create`)
+- `inputs` — Input attributes with optional types (e.g., `email:string name:String`)
+
+**Options:**
+- `--call-method` — Primary call method: `call` or `call!` (default: `call!`)
+- `--path` — Path to service files (default: `app/services`). Spec path is auto-derived: `app/X` → `spec/X`, `lib/X` → `spec/X`
+- `--skip-pending` — Skip pending placeholder

data/lib/generators/servactory/base.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+require "rails/generators/base"
+require "rails/generators/named_base"
+
+module Servactory
+  module Generators
+    class Base < Rails::Generators::Base
+      def self.gem_root
+        @gem_root ||= File.expand_path("../../..", __dir__)
+      end
+
+      def self.gem_locales_path
+        @gem_locales_path ||= File.join(gem_root, "config", "locales")
+      end
+
+      private
+
+      def gem_root
+        self.class.gem_root
+      end
+
+      def gem_locales_path
+        self.class.gem_locales_path
+      end
+    end
+
+    class NamedBase < Rails::Generators::NamedBase
+      VALID_INPUT_NAME_REGEX = /\A[a-z_][a-zA-Z0-9_]*\z/
+
+      TYPE_MAPPING = {
+        "string" => "String",
+        "integer" => "Integer",
+        "float" => "Float",
+        "boolean" => "[TrueClass, FalseClass]",
+        "bool" => "[TrueClass, FalseClass]",
+        "array" => "Array",
+        "hash" => "Hash",
+        "symbol" => "Symbol",
+        "date" => "Date",
+        "datetime" => "DateTime",
+        "time" => "Time",
+        "nil" => "NilClass",
+        "nilclass" => "NilClass",
+        "decimal" => "BigDecimal",
+        "bigdecimal" => "BigDecimal"
+      }.freeze
+
+      private
+
+      def input_names
+        @input_names ||= parsed_inputs.map { |input| input[:name] }
+      end
+
+      def parsed_inputs
+        @parsed_inputs ||= inputs.map do |input_argument|
+          parts = input_argument.to_s.split(":", 2)
+          name = parts[0].strip
+          type = normalize_type(parts[1])
+
+          validate_input_name!(name)
+
+          { name:, type: }
+        end
+      end
+
+      def validate_input_name!(name)
+        return if name.match?(VALID_INPUT_NAME_REGEX)
+
+        raise ArgumentError, "Invalid input name '#{name}'. " \
+                             "Input names must start with a lowercase letter or underscore, " \
+                             "followed by letters, numbers, or underscores."
+      end
+
+      def normalize_type(type_string)
+        return "String" if type_string.blank?
+
+        TYPE_MAPPING[type_string.downcase] || type_string
+      end
+    end
+  end
+end

data/lib/generators/servactory/extension/USAGE

@@ -0,0 +1,54 @@
+Description:
+    Generates a new Servactory extension module.
+
+Usage:
+    rails generate servactory:extension NAME [options]
+
+Arguments:
+    NAME           The name of the extension (e.g., MyExtension, Admin::AuditTrail)
+
+Options:
+    --path=PATH           Path to generate extension files (default: app/services/application_service/extensions)
+    --namespace=NAMESPACE Base namespace for the extension module (default: ApplicationService)
+
+Generated Structure:
+    The extension follows the standard Servactory extension pattern with:
+        - self.included(base) hook for module setup
+        - ClassMethods module for DSL methods (called at class definition time)
+        - InstanceMethods module for runtime behavior (call! override)
+        - stroma.settings integration for configuration storage
+
+Examples:
+    rails generate servactory:extension MyExtension
+        Creates app/services/application_service/extensions/my_extension/dsl.rb
+        Module: ApplicationService::Extensions::MyExtension::DSL
+
+    rails generate servactory:extension Admin::AuditTrail
+        Creates app/services/application_service/extensions/admin/audit_trail/dsl.rb
+        Module: ApplicationService::Extensions::Admin::AuditTrail::DSL
+
+    rails generate servactory:extension MyExtension --path=lib/my_gem/extensions
+        Creates lib/my_gem/extensions/my_extension/dsl.rb
+
+    rails generate servactory:extension MyExtension --namespace=MyApp::Services
+        Creates extension with MyApp::Services::Extensions::MyExtension::DSL namespace
+
+Usage in Service:
+    After generation, include the extension in your service base class:
+
+        # app/services/application_service/base.rb
+        module ApplicationService
+          class Base < Servactory::Base
+            extensions do
+              before :actions, ApplicationService::Extensions::MyExtension::DSL
+            end
+          end
+        end
+
+    Then use the DSL method in your services:
+
+        class MyService < ApplicationService::Base
+          my_extension!(my_setting: "value")
+
+          # ...
+        end

data/lib/generators/servactory/extension/extension_generator.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Servactory
+  module Generators
+    class ExtensionGenerator < Rails::Generators::NamedBase
+      source_root File.expand_path("templates", __dir__)
+
+      class_option :path,
+                   type: :string,
+                   default: "app/services/application_service/extensions",
+                   desc: "Path to generate extension files"
+
+      class_option :namespace,
+                   type: :string,
+                   default: "ApplicationService",
+                   desc: "Base namespace for the extension module"
+
+      def create_extension
+        template "extension.rb.tt", extension_file_path
+      end
+
+      private
+
+      def extension_file_path
+        "#{extensions_path}/#{file_path}/dsl.rb"
+      end
+
+      def extensions_path
+        options[:path]
+      end
+
+      def base_namespace
+        options[:namespace]
+      end
+
+      def extension_key
+        file_path.tr("/", "_")
+      end
+    end
+  end
+end

data/lib/generators/servactory/extension/templates/extension.rb.tt

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module <%= base_namespace %>
+  module Extensions
+    module <%= class_name %>
+      module DSL
+        # Hook called when this module is included in a service base class.
+        # Sets up both class-level DSL methods and instance-level runtime behavior.
+        def self.included(base)
+          base.extend(ClassMethods)
+          base.include(InstanceMethods)
+        end
+
+        # Class-level DSL methods - called at service class definition time.
+        # Use these to configure extension behavior for the service class.
+        module ClassMethods
+          private
+
+          # Example DSL method that stores configuration in stroma settings.
+          # Usage in service: <%= extension_key %>!(my_setting: "value")
+          def <%= extension_key %>!(my_setting: nil)
+            stroma.settings[:actions][:<%= extension_key %>][:my_setting] = my_setting
+          end
+        end
+
+        # Instance-level methods - called at service runtime.
+        # Override call! to add behavior before, after, or around service execution.
+        module InstanceMethods
+          private
+
+          # Override call! to customize service execution flow.
+          #
+          # Common patterns:
+          #   Before: validate/check conditions, then call super
+          #   After:  call super, then process outputs
+          #   Around: wrap super in context (e.g., transaction { super })
+          #   Error:  call super with rescue block for error handling
+          #
+          # Available parameters for call!:
+          #   def call!(**) - basic, most common
+          #   def call!(incoming_arguments: {}, **) - access raw arguments before input processing
+          #   def call!(collection_of_inputs:, collection_of_internals:, collection_of_outputs:, **) - full access
+          def call!(**)
+            # Access class-level configuration stored in stroma settings
+            my_setting = self.class.stroma.settings[:actions][:<%= extension_key %>][:my_setting]
+
+            # Example: Before pattern - validate before execution
+            # if my_setting.present?
+            #   fail!(:my_error, message: "Error message") unless some_condition
+            # end
+
+            # Always call super to continue the execution chain
+            super
+
+            # Example: After pattern - process outputs after execution
+            # process_result(outputs) if my_setting.present?
+          end
+        end
+      end
+    end
+  end
+end

data/lib/generators/servactory/install/USAGE

@@ -0,0 +1,27 @@
+Description:
+    Installs Servactory base service configuration into your Rails application.
+
+Usage:
+    rails generate servactory:install [options]
+
+Options:
+    --namespace=NAMESPACE    Base namespace for services (default: ApplicationService)
+    --locales=LOCALES        Locales to install (available: en, ru, de, fr, es, it)
+    --minimal                Generate minimal setup without configuration examples
+    --path=PATH              Path to install service files (default: app/services)
+
+Examples:
+    rails generate servactory:install
+        Creates app/services/application_service/ with base.rb, exceptions.rb, result.rb
+
+    rails generate servactory:install --path=lib/my_gem/services
+        Creates lib/my_gem/services/application_service/ for gem/library use
+
+    rails generate servactory:install --namespace=MyApp::Services
+        Creates app/services/my_app/services/ with all files
+
+    rails generate servactory:install --locales=en,de,fr
+        Also copies locale files to config/locales/ (available: en, ru, de, fr, es, it)
+
+    rails generate servactory:install --minimal
+        Creates minimal setup without configuration examples

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

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+require_relative "../base"
+
+module Servactory
+  module Generators
+    class InstallGenerator < Servactory::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      VALID_NAMESPACE_REGEX = /\A[A-Z][a-zA-Z0-9_]*(::[A-Z][a-zA-Z0-9_]*)*\z/
+
+      class_option :namespace,
+                   type: :string,
+                   default: "ApplicationService",
+                   desc: "Base namespace for services"
+
+      class_option :path,
+                   type: :string,
+                   default: "app/services",
+                   desc: "Path to install service files"
+
+      class_option :locales,
+                   type: :array,
+                   default: [],
+                   desc: "Locales to install (e.g., --locales=en,ru)"
+
+      class_option :minimal,
+                   type: :boolean,
+                   default: false,
+                   desc: "Generate minimal setup without configuration examples"
+
+      def create_application_service
+        validate_namespace!
+
+        template "application_service/base.rb.tt", service_path("base.rb")
+        template "application_service/exceptions.rb.tt", service_path("exceptions.rb")
+        template "application_service/result.rb.tt", service_path("result.rb")
+
+        create_file service_path("dynamic_options/.keep"), ""
+        create_file service_path("extensions/.keep"), ""
+      end
+
+      def copy_locales
+        return if locales.blank?
+
+        locales.each do |locale|
+          locale_file = "servactory.#{locale}.yml"
+          source_path = File.join(gem_locales_path, "#{locale}.yml")
+
+          if File.exist?(source_path)
+            copy_file source_path, "config/locales/#{locale_file}"
+          else
+            say "Locale file not found: #{locale} (expected at #{source_path})", :yellow
+          end
+        end
+      end
+
+      private
+
+      def validate_namespace!
+        return if namespace.match?(VALID_NAMESPACE_REGEX)
+
+        raise ArgumentError, "Invalid namespace '#{namespace}'. " \
+                             "Namespace must be a valid Ruby constant name " \
+                             "(e.g., 'ApplicationService', 'MyApp::Services')."
+      end
+
+      def namespace
+        options[:namespace]
+      end
+
+      def namespace_path
+        namespace.underscore
+      end
+
+      def base_path
+        options[:path]
+      end
+
+      def service_path(filename)
+        "#{base_path}/#{namespace_path}/#{filename}"
+      end
+
+      def locales
+        # Handle both "--locales=en,ru" (single string) and "--locales en ru" (array)
+        options[:locales].flat_map { |locale| locale.split(",") }
+      end
+
+      def minimal?
+        options[:minimal]
+      end
+    end
+  end
+end