ecoportal-api-graphql 1.3.5 → 1.3.9

data/lib/ecoportal/api/graphql/input/workflow_command.rb

@@ -0,0 +1,251 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          SCHEMA_VERSION = '20260605'.freeze
+
+          COMMAND_MAP = {
+            # Page-level
+            editPage:                          'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditPage',
+            editPageCreatorPermissions:        'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditPageCreatorPermissions',
+            # Stage structural
+            addStage:                          'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddStage',
+            removeStage:                       'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveStage',
+            editStage:                         'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditStage',
+            moveStage:                         'Ecoportal::API::GraphQL::Input::WorkflowCommand::MoveStage',
+            # Stage permissions
+            editCreatorPermissions:            'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditCreatorPermissions',
+            editRestrictCommentTagging:        'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditRestrictCommentTagging',
+            addCommentTaggingUserGroup:        'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddCommentTaggingUserGroup',
+            removeCommentTaggingUserGroup:     'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveCommentTaggingUserGroup',
+            editRestrictTaskAssignment:        'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditRestrictTaskAssignment',
+            addTaskAssignmentUserGroup:        'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddTaskAssignmentUserGroup',
+            removeTaskAssignmentUserGroup:     'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveTaskAssignmentUserGroup',
+            addStageTag:                       'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddStageTag',
+            removeStageTag:                    'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveStageTag',
+            # Section
+            addSection:                        'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddSection',
+            removeSection:                     'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveSection',
+            addStageSection:                   'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddStageSection',
+            removeStageSection:                'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveStageSection',
+            editSectionHeader:                 'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditSectionHeader',
+            collapseSection:                   'Ecoportal::API::GraphQL::Input::WorkflowCommand::CollapseSection',
+            expandSection:                     'Ecoportal::API::GraphQL::Input::WorkflowCommand::ExpandSection',
+            reorderSection:                    'Ecoportal::API::GraphQL::Input::WorkflowCommand::ReorderSection',
+            # Task
+            addTask:                           'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddTask',
+            removeTask:                        'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveTask',
+            editTaskDue:                       'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditTaskDue',
+            removeTaskDue:                     'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveTaskDue',
+            removeTaskPriorityLevel:           'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveTaskPriorityLevel',
+            editRequiredSignOffs:              'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditRequiredSignOffs',
+            # Strategy (default)
+            addDefaultStrategy:                'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddDefaultStrategy',
+            editDefaultStrategy:               'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditDefaultStrategy',
+            removeDefaultStrategy:             'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveDefaultStrategy',
+            addDefaultDirectStrategyUser:      'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddDefaultDirectStrategyUser',
+            removeDefaultDirectStrategyUser:   'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveDefaultDirectStrategyUser',
+            # Strategy (task)
+            addStrategy:                       'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddStrategy',
+            editStrategy:                      'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditStrategy',
+            removeStrategy:                    'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveStrategy',
+            addDirectStrategyUser:             'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddDirectStrategyUser',
+            removeDirectStrategyUser:          'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveDirectStrategyUser',
+            # Strategy (operation)
+            addOperationStrategy:              'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddOperationStrategy',
+            editOperationStrategy:             'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditOperationStrategy',
+            removeOperationStrategy:           'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveOperationStrategy',
+            addOperationDirectStrategyUser:    'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddOperationDirectStrategyUser',
+            removeOperationDirectStrategyUser: 'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveOperationDirectStrategyUser',
+            # Callbacks
+            addWorkflowCallback:               'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddWorkflowCallback',
+            removeCallback:                    'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveCallback',
+            editTrigger:                       'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditTrigger',
+            # Operations
+            addOperation:                      'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddOperation',
+            editOperation:                     'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditOperation',
+            removeOperation:                   'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveOperation',
+            # Recipients
+            addRecipientUser:                  'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddRecipientUser',
+            removeRecipientUser:               'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveRecipientUser',
+            addRecipientPeopleField:           'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddRecipientPeopleField',
+            removeRecipientPeopleField:        'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveRecipientPeopleField',
+            addRecipientTaskConfig:            'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddRecipientTaskConfig',
+            removeRecipientTaskConfig:         'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveRecipientTaskConfig',
+            addRecipientActionType:            'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddRecipientActionType',
+            removeRecipientActionType:         'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveRecipientActionType',
+            addRecipientFilter:                'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddRecipientFilter',
+            removeRecipientFilter:             'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveRecipientFilter',
+            # Scheduled
+            addScheduledCallback:              'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddScheduledCallback',
+            editScheduledCallback:             'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditScheduledCallback',
+            removeScheduledCallback:           'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveScheduledCallback',
+            addScheduledCallbackAction:        'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddScheduledCallbackAction',
+            editReminder:                      'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditReminder',
+            addActionTag:                      'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddActionTag',
+            removeActionTag:                   'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveActionTag',
+            # Fields structural
+            addField:                          'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddField',
+            moveField:                         'Ecoportal::API::GraphQL::Input::WorkflowCommand::MoveField',
+            removeField:                       'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveField',
+            # Field config
+            editFieldConfiguration:            'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditFieldConfiguration',
+            # Select options
+            addSelectFieldOption:              'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddSelectFieldOption',
+            editSelectFieldOption:             'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditSelectFieldOption',
+            removeSelectFieldOption:           'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveSelectFieldOption',
+            # Gauge stops
+            addGaugeFieldStop:                 'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddGaugeFieldStop',
+            editGaugeFieldStop:                'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditGaugeFieldStop',
+            removeGaugeFieldStop:              'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveGaugeFieldStop',
+            # Linked fields
+            addLinkedFieldConfig:              'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddLinkedFieldConfig',
+            editLinkedFieldConfig:             'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditLinkedFieldConfig',
+            removeLinkedFieldConfig:           'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveLinkedFieldConfig',
+            # Forces
+            addForce:                          'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddForce',
+            removeForce:                       'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveForce',
+            editForce:                         'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditForce',
+            reorderForces:                     'Ecoportal::API::GraphQL::Input::WorkflowCommand::ReorderForces',
+            addBinding:                        'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddBinding',
+            editBinding:                       'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditBinding',
+            removeBinding:                     'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveBinding',
+            addLinkedHelper:                   'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddLinkedHelper',
+            editLinkedHelper:                  'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditLinkedHelper',
+            removeLinkedHelper:                'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveLinkedHelper'
+          }.freeze
+
+          def self.build(command_key, **kwargs)
+            validate_key!(command_key)
+            sub_mod = Object.const_get(COMMAND_MAP[command_key])
+            { command_key => sub_mod.build(**kwargs) }
+          end
+
+          def self.valid_key?(key)
+            COMMAND_MAP.key?(key)
+          end
+
+          def self.build_commands(commands_spec)
+            commands_spec.map do |spec|
+              if spec.keys.size == 1 && COMMAND_MAP.key?(spec.keys.first)
+                build(spec.keys.first, **spec.values.first)
+              else
+                spec
+              end
+            end
+          end
+
+          private_class_method def self.validate_key!(key)
+            return if COMMAND_MAP.key?(key)
+
+            raise ArgumentError, "Unknown WorkflowCommandInput key: #{key}. Valid keys: #{COMMAND_MAP.keys.join(', ')}"
+          end
+        end
+      end
+    end
+  end
+end
+
+require_relative 'workflow_command/edit_page'
+require_relative 'workflow_command/edit_page_creator_permissions'
+require_relative 'workflow_command/add_stage'
+require_relative 'workflow_command/remove_stage'
+require_relative 'workflow_command/edit_stage'
+require_relative 'workflow_command/move_stage'
+require_relative 'workflow_command/edit_creator_permissions'
+require_relative 'workflow_command/edit_restrict_comment_tagging'
+require_relative 'workflow_command/add_comment_tagging_user_group'
+require_relative 'workflow_command/remove_comment_tagging_user_group'
+require_relative 'workflow_command/edit_restrict_task_assignment'
+require_relative 'workflow_command/add_task_assignment_user_group'
+require_relative 'workflow_command/remove_task_assignment_user_group'
+require_relative 'workflow_command/add_stage_tag'
+require_relative 'workflow_command/remove_stage_tag'
+require_relative 'workflow_command/add_section'
+require_relative 'workflow_command/remove_section'
+require_relative 'workflow_command/add_stage_section'
+require_relative 'workflow_command/remove_stage_section'
+require_relative 'workflow_command/edit_section_header'
+require_relative 'workflow_command/collapse_section'
+require_relative 'workflow_command/expand_section'
+require_relative 'workflow_command/reorder_section'
+require_relative 'workflow_command/add_task'
+require_relative 'workflow_command/remove_task'
+require_relative 'workflow_command/edit_task_due'
+require_relative 'workflow_command/remove_task_due'
+require_relative 'workflow_command/remove_task_priority_level'
+require_relative 'workflow_command/edit_required_sign_offs'
+require_relative 'workflow_command/add_default_strategy'
+require_relative 'workflow_command/edit_default_strategy'
+require_relative 'workflow_command/remove_default_strategy'
+require_relative 'workflow_command/add_default_direct_strategy_user'
+require_relative 'workflow_command/remove_default_direct_strategy_user'
+require_relative 'workflow_command/add_strategy'
+require_relative 'workflow_command/edit_strategy'
+require_relative 'workflow_command/remove_strategy'
+require_relative 'workflow_command/add_direct_strategy_user'
+require_relative 'workflow_command/remove_direct_strategy_user'
+require_relative 'workflow_command/add_operation_strategy'
+require_relative 'workflow_command/edit_operation_strategy'
+require_relative 'workflow_command/remove_operation_strategy'
+require_relative 'workflow_command/add_operation_direct_strategy_user'
+require_relative 'workflow_command/remove_operation_direct_strategy_user'
+require_relative 'workflow_command/add_workflow_callback'
+require_relative 'workflow_command/remove_callback'
+require_relative 'workflow_command/edit_trigger'
+require_relative 'workflow_command/add_operation'
+require_relative 'workflow_command/edit_operation'
+require_relative 'workflow_command/remove_operation'
+require_relative 'workflow_command/add_recipient_user'
+require_relative 'workflow_command/remove_recipient_user'
+require_relative 'workflow_command/add_recipient_people_field'
+require_relative 'workflow_command/remove_recipient_people_field'
+require_relative 'workflow_command/add_recipient_task_config'
+require_relative 'workflow_command/remove_recipient_task_config'
+require_relative 'workflow_command/add_recipient_action_type'
+require_relative 'workflow_command/remove_recipient_action_type'
+require_relative 'workflow_command/add_recipient_filter'
+require_relative 'workflow_command/remove_recipient_filter'
+require_relative 'workflow_command/add_scheduled_callback'
+require_relative 'workflow_command/edit_scheduled_callback'
+require_relative 'workflow_command/remove_scheduled_callback'
+require_relative 'workflow_command/add_scheduled_callback_action'
+require_relative 'workflow_command/edit_reminder'
+require_relative 'workflow_command/add_action_tag'
+require_relative 'workflow_command/remove_action_tag'
+require_relative 'workflow_command/add_field'
+require_relative 'workflow_command/move_field'
+require_relative 'workflow_command/remove_field'
+require_relative 'workflow_command/edit_field_configuration'
+require_relative 'workflow_command/add_select_field_option'
+require_relative 'workflow_command/edit_select_field_option'
+require_relative 'workflow_command/remove_select_field_option'
+require_relative 'workflow_command/add_gauge_field_stop'
+require_relative 'workflow_command/edit_gauge_field_stop'
+require_relative 'workflow_command/remove_gauge_field_stop'
+require_relative 'workflow_command/add_linked_field_config'
+require_relative 'workflow_command/edit_linked_field_config'
+require_relative 'workflow_command/remove_linked_field_config'
+require_relative 'workflow_command/add_force'
+require_relative 'workflow_command/remove_force'
+require_relative 'workflow_command/edit_force'
+require_relative 'workflow_command/reorder_forces'
+require_relative 'workflow_command/add_binding'
+require_relative 'workflow_command/edit_binding'
+require_relative 'workflow_command/remove_binding'
+require_relative 'workflow_command/add_linked_helper'
+require_relative 'workflow_command/edit_linked_helper'
+require_relative 'workflow_command/remove_linked_helper'
+require_relative 'workflow_command/field_config/contractor_entities'
+require_relative 'workflow_command/field_config/cross_reference'
+require_relative 'workflow_command/field_config/date'
+require_relative 'workflow_command/field_config/gauge'
+require_relative 'workflow_command/field_config/image_gallery'
+require_relative 'workflow_command/field_config/location_field'
+require_relative 'workflow_command/field_config/people'
+require_relative 'workflow_command/field_config/plain_text'
+require_relative 'workflow_command/field_config/rich_text'
+require_relative 'workflow_command/field_config/select'
+require_relative 'workflow_command/field_config/signature'
+require_relative 'workflow_command/field_config/table'

data/lib/ecoportal/api/graphql/input.rb

@@ -14,3 +14,11 @@ require_relative 'input/search'
 require_relative 'input/location_structure'
 require_relative 'input/contractor_entity'
 require_relative 'input/action'
+require_relative 'input/page'
+require_relative 'input/delta_input'
+require_relative 'input/search_conf'
+
+require_relative 'input/register'
+require_relative 'input/preset_view'
+require_relative 'input/workflow_command'
+require_relative 'input/variable_binding'

data/lib/ecoportal/api/graphql/interface/base_page.rb

@@ -1,58 +1,100 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Interface
-        class BasePage < Logic::BaseModel
-          passkey :id
-          passthrough :name, :uid
-          passthrough :icon
-
-          class_resolver :location_node_class, 'Ecoportal::API::GraphQL::Interface::LocationStructure::Node'
-          class_resolver :user_class, 'Ecoportal::API::GraphQL::Base::User'
-          # class_resolver :force_class, 'Ecoportal::API::GraphQL::Base::Force'
-          # class_resolver :task_class, 'Ecoportal::API::GraphQL::Interface::Task'
-          # class_resolver :theme_class, 'Ecoportal::API::GraphQL::Base::Theme'
-          # class_resolver :template_class, 'Ecoportal::API::GraphQL::Base::Template'
-          # class_resolver :register_class, 'Ecoportal::API::GraphQL::Base::Register'
-          class_resolver :organization_class, 'Ecoportal::API::GraphQL::Base::Organization'
-
-          passthrough :autoSelectedLocations
-          embeds_many :locations, klass: :location_node_class, read_only: true
-          embeds_many :allLocations, klass: :location_node_class, read_only: true
-          passarray :otherTags, :baseTags
-
-          # embeds_one :state, klass: 'BasePage::StateEnum', read_only: true
-          passthrough :state
-          # embeds_one :taskPriority, klass: 'BasePage::TaskPriorityEnum', read_only: true
-          passthrough :taskPriority
-
-
-          passthrough :patchVer
-
-          passboolean :archived
-          passdate :archivedAt
-
-          passthrough :timeZone
-          passdate :createdAt, :updatedAt
-          passthrough :creatorName, :lastUpdatedByName
-          # embeds_one :creator, klass: :user_class, read_only: true
-
-          passboolean :hasForces
-          # embeds_many :forces, klass: :force_class
-
-          # embeds_many :tasks, klass: :task_class, read_only: true
-          # embeds_many :activeTasks, klass: :task_class, read_only: true
-
-          # embeds_one :theme, klass: :theme_class
-
-          passthrough :sourceTemplateId
-          # embeds_one :template, klass: :template_class, read_only: true
-          # embeds_many :registers, klass: :register_class, read_only: true
-          # embeds_one :organization, klass: :organization_class, read_only: true
-
-          passboolean :inSystemPagesEnabled, :printingEnabled
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Interface
+        class BasePage < Logic::BaseModel
+          include Concerns::PageCompat
+          include Concerns::DataFieldAccess
+
+          passkey :id
+          passthrough :name, :uid
+          passthrough :icon
+
+          class_resolver :location_node_class, 'Ecoportal::API::GraphQL::Interface::LocationStructure::Node'
+          class_resolver :user_class, 'Ecoportal::API::GraphQL::Base::User'
+          # class_resolver :force_class, 'Ecoportal::API::GraphQL::Base::Force'
+          # class_resolver :task_class, 'Ecoportal::API::GraphQL::Interface::Task'
+          # class_resolver :theme_class, 'Ecoportal::API::GraphQL::Base::Theme'
+          # class_resolver :template_class, 'Ecoportal::API::GraphQL::Base::Template'
+          # class_resolver :register_class, 'Ecoportal::API::GraphQL::Base::Register'
+          class_resolver :organization_class, 'Ecoportal::API::GraphQL::Base::Organization'
+
+          passthrough :autoSelectedLocations
+          embeds_many :locations, klass: :location_node_class, read_only: true
+          embeds_many :allLocations, klass: :location_node_class, read_only: true
+          passarray :otherTags, :baseTags
+
+          # Page-level location assignment. Locations are set on the PAGE (UpdatePageInput.page
+          # .locations = [LocationInput{id}]) — NOT via the location data field (LocationFieldInput
+          # has no value). The `locations` embed above is read_only, so write the raw doc here so
+          # as_update serialises it under PAGE_FIELD_KEYS (:locations).
+          def location_ids
+            Array(doc['locations']).map { |l| l.is_a?(Hash) ? l['id'] : l }.compact
+          end
+
+          def location_ids=(ids)
+            doc['locations'] = Array(ids).map { |id_val| { 'id' => id_val } }
+          end
+
+          # embeds_one :state, klass: 'BasePage::StateEnum', read_only: true
+          passthrough :state
+          # embeds_one :taskPriority, klass: 'BasePage::TaskPriorityEnum', read_only: true
+          passthrough :taskPriority
+
+
+          passthrough :patchVer
+
+          passboolean :draft, :archived
+          passdate :archivedAt
+          passthrough :externalId
+
+          passthrough :timeZone
+          passdate :createdAt, :updatedAt
+          passthrough :creatorName, :lastUpdatedByName
+          # embeds_one :creator, klass: :user_class, read_only: true
+
+          passboolean :hasForces
+
+          # Returns a Force::Collection wrapping the page's forces array.
+          # Forces are only populated when the query includes the ForceFields fragment
+          # (e.g. via Query::PageWithForces — used by OozeRedirect::ForceCompat).
+          # Returns an empty collection when forces were not queried.
+          def forces
+            @forces ||= Base::Force::Collection.new(doc['forces'] || [])
+          end
+
+          # embeds_many :tasks, klass: :task_class, read_only: true
+          # embeds_many :activeTasks, klass: :task_class, read_only: true
+
+          # embeds_one :theme, klass: :theme_class
+
+          passthrough :sourceTemplateId
+
+          # Compat marker (not a server field). Compat::Pages#get_new records the source
+          # template id here when it builds a draft from a template — the read fragment does
+          # NOT fetch sourceTemplateId, so the model can't recover it from the doc. Lets the
+          # dry-run know this is a never-saved CREATE draft (a built draft DOES carry a
+          # patchVer, so patchVer-nil alone can't detect it) and supplies the templateId for
+          # the CreateFromTemplateInput preview. nil for fetched/persisted pages.
+          attr_accessor :_compat_source_template_id
+
+          # embeds_one :template, klass: :template_class, read_only: true
+          # embeds_many :registers, klass: :register_class, read_only: true
+          # embeds_one :organization, klass: :organization_class, read_only: true
+
+          passboolean :inSystemPagesEnabled, :printingEnabled
+          passboolean :hasSmartFields, :contentShareable, :enableEmailOut
+          passthrough :totalReferencesCount, :mouldCounter
+
+          class_resolver :pages_workflow_class, 'Ecoportal::API::GraphQL::Model::PagesWorkflow'
+
+          def workflow
+            return nil unless (raw = doc['workflow'])
+
+            @workflow ||= pages_workflow_class.new(raw)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/interface/location_structure/nodes.rb

@@ -1,28 +1,27 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Interface
-        module LocationStructure
-          class Nodes < Logic::BaseModel
-            extend Helpers::LocationsTree
-
-            root!
-
-            class_resolver :location_node_class, Node
-
-            embeds_many :nodes, klass: :location_node_class, order_key: :weight
-
-            def draft?
-              false
-            end
-
-            def treeify
-              self.class.treeify(nodes)
-            end
-          end
-        end
-      end
-    end
-  end
-end
-
+module Ecoportal
+  module API
+    class GraphQL
+      module Interface
+        module LocationStructure
+          class Nodes < Logic::BaseModel
+            extend Helpers::LocationsTree
+
+            root!
+
+            class_resolver :location_node_class, Node
+
+            embeds_many :nodes, klass: :location_node_class, order_key: :weight
+
+            def draft?
+              false
+            end
+
+            def treeify
+              self.class.treeify(nodes)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/logic/base_model.rb

@@ -3,6 +3,8 @@ module Ecoportal
     class GraphQL
       module Logic
         class BaseModel < Ecoportal::API::Common::GraphQL::Model
+          include Ecoportal::API::GraphQL::Concerns::SnakeCamelAccess
+
           class << self
             attr_accessor :client
           end

data/lib/ecoportal/api/graphql/logic/base_query.rb

@@ -8,6 +8,8 @@ module Ecoportal
           inheritable_attrs :accepted_params, :param_defaults
 
           DETAIL_ERRORS = [
+            Ecoportal::API::Common::GraphQL::ResponseError,
+            Ecoportal::API::Common::Client::Error::UnexpectedServerError,
             Faraday::ParsingError,
             Graphlient::Errors::FaradayServerError,
             Graphlient::Errors::GraphQLError,
@@ -110,12 +112,31 @@ module Ecoportal
             raise "This method should be implemented in the child class #{self.class}"
           end
 
+          # Types that should be passed through as-is as GraphQL variable values.
+          # Anything else that responds to to_h is treated as a serialisable value object.
+          VARIABLE_PRIMITIVES = [
+            ::NilClass, ::TrueClass, ::FalseClass,
+            ::Integer, ::Float, ::String, ::Symbol,
+            ::Hash, ::Array
+          ].freeze
+          private_constant :VARIABLE_PRIMITIVES
+
+          def normalize_variables(kargs)
+            kargs.transform_values do |v|
+              VARIABLE_PRIMITIVES.any? { |t| v.is_a?(t) } || !v.respond_to?(:to_h) ? v : v.to_h
+            end
+          end
+
           def graphql_query(path: self.path, raw_response: {}, **kargs, &block)
             default_params = self.class.param_defaults.dup
-            query_params   = self.class.slice_params(default_params.merge(kargs))
+            query_params   = self.class.slice_params(normalize_variables(default_params.merge(kargs)))
+
+            query_str    = client.to_query_string(&block)
+            fragment_str = assemble_fragments(query_str)
+            full_query   = fragment_str.empty? ? query_str : "#{query_str}\n\n#{fragment_str}"
 
             request(*path) do
-              client.query(**query_params, &block).tap do |response|
+              client.http_client.execute(full_query, variables: query_params).tap do |response|
                 raw_response[:data] = response
               end
             end
@@ -132,6 +153,28 @@ module Ecoportal
             wrap_response(response, path)
           end
 
+          # Resolves all fragment spreads in query_str, recursively following
+          # spreads inside assembled fragment bodies until no new names are found.
+          # Names that don't resolve to a registered fragment are skipped safely.
+          def assemble_fragments(query_str)
+            tried     = {}
+            assembled = {}
+            pending   = query_str.scan(/\.\.\.(\w+)/).flatten.map(&:to_sym).uniq
+
+            until (unresolved = pending.reject { |n| tried.key?(n) }).empty?
+              unresolved.each do |name|
+                tried[name] = true
+                frag        = Ecoportal::API::GraphQL::Fragment.assemble(name)
+                next if frag.empty?
+
+                assembled[name] = frag
+                pending |= frag.scan(/\.\.\.(\w+)/).flatten.map(&:to_sym)
+              end
+            end
+
+            assembled.values.join("\n\n")
+          end
+
           def wrap_response(response, path = [])
             # we use the Hash, because fragments are persmissioned
             # see Use of Fragments at https://github.com/ashkan18/graphlient/tree/master?tab=readme-ov-file#use-of-fragments

data/lib/ecoportal/api/graphql/logic/input.rb

@@ -4,6 +4,21 @@ module Ecoportal
       module Logic
         class Input < Logic::BaseModel
           passthrough :clientMutationId
+
+          class << self
+            # Builds a mutation input hash from a model's diff.
+            # Subclasses override this to reshape fields (e.g. array → IdDiffInput).
+            # @param model [Common::GraphQL::Model] the subject model.
+            # @return [Hash, nil] the mutation input hash, or nil when there are no changes.
+            def from_model(model, client_mutation_id: '')
+              diff = model.as_update
+              return nil if diff.nil?
+
+              diff[:patchVer]         = model.patchVer if model.respond_to?(:patchVer) && !model.patchVer.nil?
+              diff[:clientMutationId] = client_mutation_id unless client_mutation_id.to_s.empty?
+              diff
+            end
+          end
         end
       end
     end

data/lib/ecoportal/api/graphql/model/ai_summary_version.rb

@@ -0,0 +1,10 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        class AiSummaryVersion < Base::AiSummaryVersion
+        end
+      end
+    end
+  end
+end