ea 0.1.0 → 0.1.4

data/lib/ea/qea/models/ea_diagram_object.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Ea
+  module Qea
+    module Models
+      # Represents a diagram object from the t_diagramobjects table
+      #
+      # This model represents the placement of UML elements (classes, packages,
+      # etc.) on specific diagrams, including their position and styling.
+      class EaDiagramObject < BaseModel
+        attribute :diagram_id, Lutaml::Model::Type::Integer
+        attribute :ea_object_id, Lutaml::Model::Type::Integer
+        attribute :recttop, Lutaml::Model::Type::Integer
+        attribute :rectleft, Lutaml::Model::Type::Integer
+        attribute :rectright, Lutaml::Model::Type::Integer
+        attribute :rectbottom, Lutaml::Model::Type::Integer
+        attribute :sequence, Lutaml::Model::Type::Integer
+        attribute :objectstyle, Lutaml::Model::Type::String
+        attribute :instance_id, Lutaml::Model::Type::Integer
+
+        def self.primary_key_column
+          :instance_id
+        end
+
+        def self.table_name
+          "t_diagramobjects"
+        end
+
+
+        COLUMN_MAP = {
+          "Object_ID" => :ea_object_id,
+        }.freeze
+
+        def self.column_map
+          COLUMN_MAP
+        end
+
+        # Get the bounding box of the diagram object
+        # @return [Hash] Hash with :top, :left, :right, :bottom, :width, :height
+        def bounding_box
+          {
+            top: recttop,
+            left: rectleft,
+            right: rectright,
+            bottom: rectbottom,
+            width: rectright - rectleft,
+            height: rectbottom - recttop,
+          }
+        end
+
+        # Get the center point of the diagram object
+        # @return [Hash] Hash with :x, :y coordinates
+        def center_point
+          {
+            x: (rectleft + rectright) / 2,
+            y: (recttop + rectbottom) / 2,
+          }
+        end
+
+        # Parse ObjectStyle string into a hash
+        # @return [Hash] Parsed style attributes
+        def parsed_style
+          return {} unless objectstyle
+
+          objectstyle.split(";").each_with_object({}) do |pair, hash|
+            key, value = pair.split("=", 2)
+            hash[key] = value if key && value
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ea/qea/models/ea_diagram_type.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Ea
+  module Qea
+    module Models
+      # Represents a diagram type definition from t_diagramtypes table
+      #
+      # This table provides reference data for diagram types available in EA.
+      # These define the types of UML diagrams that can be created.
+      #
+      # @example
+      #   diagram_type = EaDiagramType.new
+      #   diagram_type.diagram_type #=> "Logical"
+      #   diagram_type.name #=> "Logical View"
+      #   diagram_type.package_id #=> 1
+      class EaDiagramType < BaseModel
+        attribute :diagram_type, Lutaml::Model::Type::String
+        attribute :name, Lutaml::Model::Type::String
+        attribute :package_id, Lutaml::Model::Type::Integer
+
+        def self.table_name
+          "t_diagramtypes"
+        end
+
+        # Primary key is Diagram_Type (text)
+        def self.primary_key_column
+          "Diagram_Type"
+        end
+
+        # Friendly type name
+        # @return [String]
+        def type_name
+          diagram_type
+        end
+
+        # Check if this is a class diagram
+        # @return [Boolean]
+        def class_diagram?
+          diagram_type == "Logical"
+        end
+
+        # Check if this is an activity diagram
+        # @return [Boolean]
+        def activity_diagram?
+          diagram_type == "Activity"
+        end
+
+        # Check if this is a use case diagram
+        # @return [Boolean]
+        def use_case_diagram?
+          diagram_type == "UseCase"
+        end
+      end
+    end
+  end
+end

data/lib/ea/qea/models/ea_document.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Ea
+  module Qea
+    module Models
+      # Represents a document from the t_document table in EA database
+      # Stores documentation style templates and artifacts
+      class EaDocument < BaseModel
+        attribute :doc_id, Lutaml::Model::Type::String
+        attribute :doc_name, Lutaml::Model::Type::String
+        attribute :doc_type, Lutaml::Model::Type::String
+        attribute :str_content, Lutaml::Model::Type::String
+        attribute :bin_content, Lutaml::Model::Type::String
+        attribute :element_id, Lutaml::Model::Type::String
+
+        def self.primary_key_column
+          :doc_id
+        end
+
+        def self.table_name
+          "t_document"
+        end
+
+
+        COLUMN_MAP = {
+          "DocID" => :doc_id,
+          "DocName" => :doc_name,
+          "DocType" => :doc_type,
+          "StrContent" => :str_content,
+          "BinContent" => :bin_content,
+          "ElementID" => :element_id,
+        }.freeze
+
+        def self.column_map
+          COLUMN_MAP
+        end
+
+        # Convenience aliases
+        alias_method :id, :doc_id
+        alias_method :name, :doc_name
+        alias_method :type, :doc_type
+
+        # Check if this is a style document
+        # @return [Boolean]
+        def style_document?
+          doc_type == "SSDOCSTYLE"
+        end
+
+        # Check if document has string content
+        # @return [Boolean]
+        def has_content?
+          !str_content.nil? && !str_content.empty?
+        end
+
+        # Check if document has binary content
+        # @return [Boolean]
+        def has_binary_content?
+          !bin_content.nil? && !bin_content.empty?
+        end
+      end
+    end
+  end
+end

data/lib/ea/qea/models/ea_object.rb

@@ -0,0 +1,223 @@
+# frozen_string_literal: true
+
+module Ea
+  module Qea
+    module Models
+      class EaObject < BaseModel
+        attribute :ea_object_id, Lutaml::Model::Type::Integer
+        attribute :object_type, Lutaml::Model::Type::String
+        attribute :diagram_id, Lutaml::Model::Type::Integer
+        attribute :name, Lutaml::Model::Type::String
+        attribute :alias, Lutaml::Model::Type::String
+        attribute :author, Lutaml::Model::Type::String
+        attribute :version, Lutaml::Model::Type::String
+        attribute :note, Lutaml::Model::Type::String
+        attribute :package_id, Lutaml::Model::Type::Integer
+        attribute :stereotype, Lutaml::Model::Type::String
+        attribute :ntype, Lutaml::Model::Type::Integer
+        attribute :complexity, Lutaml::Model::Type::String
+        attribute :effort, Lutaml::Model::Type::Integer
+        attribute :style, Lutaml::Model::Type::String
+        attribute :backcolor, Lutaml::Model::Type::Integer
+        attribute :borderstyle, Lutaml::Model::Type::Integer
+        attribute :borderwidth, Lutaml::Model::Type::Integer
+        attribute :fontcolor, Lutaml::Model::Type::Integer
+        attribute :bordercolor, Lutaml::Model::Type::Integer
+        attribute :createddate, Lutaml::Model::Type::String
+        attribute :modifieddate, Lutaml::Model::Type::String
+        attribute :status, Lutaml::Model::Type::String
+        attribute :abstract, Lutaml::Model::Type::String
+        attribute :tagged, Lutaml::Model::Type::Integer
+        attribute :pdata1, Lutaml::Model::Type::String
+        attribute :pdata2, Lutaml::Model::Type::String
+        attribute :pdata3, Lutaml::Model::Type::String
+        attribute :pdata4, Lutaml::Model::Type::String
+        attribute :pdata5, Lutaml::Model::Type::String
+        attribute :concurrency, Lutaml::Model::Type::String
+        attribute :visibility, Lutaml::Model::Type::String
+        attribute :persistence, Lutaml::Model::Type::String
+        attribute :cardinality, Lutaml::Model::Type::String
+        attribute :gentype, Lutaml::Model::Type::String
+        attribute :genfile, Lutaml::Model::Type::String
+        attribute :header1, Lutaml::Model::Type::String
+        attribute :header2, Lutaml::Model::Type::String
+        attribute :phase, Lutaml::Model::Type::String
+        attribute :scope, Lutaml::Model::Type::String
+        attribute :genoption, Lutaml::Model::Type::String
+        attribute :genlinks, Lutaml::Model::Type::String
+        attribute :classifier, Lutaml::Model::Type::Integer
+        attribute :ea_guid, Lutaml::Model::Type::String
+        attribute :parentid, Lutaml::Model::Type::Integer
+        attribute :runstate, Lutaml::Model::Type::String
+        attribute :classifier_guid, Lutaml::Model::Type::String
+        attribute :tpos, Lutaml::Model::Type::Integer
+        attribute :isroot, Lutaml::Model::Type::Integer
+        attribute :isleaf, Lutaml::Model::Type::Integer
+        attribute :isspec, Lutaml::Model::Type::Integer
+        attribute :isactive, Lutaml::Model::Type::Integer
+        attribute :stateflags, Lutaml::Model::Type::String
+        attribute :packageflags, Lutaml::Model::Type::String
+        attribute :multiplicity, Lutaml::Model::Type::String
+        attribute :styleex, Lutaml::Model::Type::String
+        attribute :actionflags, Lutaml::Model::Type::String
+        attribute :eventflags, Lutaml::Model::Type::String
+
+        COLUMN_MAP = {
+          "Object_ID" => :ea_object_id,
+          "Object_Type" => :object_type,
+          "Diagram_ID" => :diagram_id,
+          "Name" => :name,
+          "Alias" => :alias,
+          "Author" => :author,
+          "Version" => :version,
+          "Note" => :note,
+          "Package_ID" => :package_id,
+          "Stereotype" => :stereotype,
+          "NType" => :ntype,
+          "Complexity" => :complexity,
+          "Effort" => :effort,
+          "Style" => :style,
+          "BackColor" => :backcolor,
+          "BorderStyle" => :borderstyle,
+          "BorderWidth" => :borderwidth,
+          "Fontcolor" => :fontcolor,
+          "Bordercolor" => :bordercolor,
+          "CreatedDate" => :createddate,
+          "ModifiedDate" => :modifieddate,
+          "Status" => :status,
+          "Abstract" => :abstract,
+          "Tagged" => :tagged,
+          "PDATA1" => :pdata1,
+          "PDATA2" => :pdata2,
+          "PDATA3" => :pdata3,
+          "PDATA4" => :pdata4,
+          "PDATA5" => :pdata5,
+          "Concurrency" => :concurrency,
+          "Visibility" => :visibility,
+          "Persistence" => :persistence,
+          "Cardinality" => :cardinality,
+          "GenType" => :gentype,
+          "GenFile" => :genfile,
+          "Header1" => :header1,
+          "Header2" => :header2,
+          "Phase" => :phase,
+          "Scope" => :scope,
+          "GenOption" => :genoption,
+          "GenLinks" => :genlinks,
+          "Classifier" => :classifier,
+          "ea_guid" => :ea_guid,
+          "ParentID" => :parentid,
+          "RunState" => :runstate,
+          "Classifier_guid" => :classifier_guid,
+          "TPos" => :tpos,
+          "IsRoot" => :isroot,
+          "IsLeaf" => :isleaf,
+          "IsSpec" => :isspec,
+          "IsActive" => :isactive,
+          "StateFlags" => :stateflags,
+          "PackageFlags" => :packageflags,
+          "Multiplicity" => :multiplicity,
+          "StyleEx" => :styleex,
+          "ActionFlags" => :actionflags,
+          "EventFlags" => :eventflags,
+        }.freeze
+
+        def self.column_map
+          COLUMN_MAP
+        end
+
+        def self.primary_key_column
+          :ea_object_id
+        end
+
+        def self.table_name
+          "t_object"
+        end
+
+        def abstract?
+          abstract == "1"
+        end
+
+        def uml_class?
+          object_type == "Class"
+        end
+
+        def interface?
+          object_type == "Interface"
+        end
+
+        def component?
+          object_type == "Component"
+        end
+
+        def package?
+          object_type == "Package"
+        end
+
+        def enumeration?
+          object_type == "Enumeration"
+        end
+
+        def data_type?
+          object_type == "DataType"
+        end
+
+        def instance?
+          object_type == "Object"
+        end
+
+        def root?
+          isroot == 1
+        end
+
+        def leaf?
+          isleaf == 1
+        end
+
+        # Resolve the transformer registry key for this object's type.
+        # Considers both object_type and stereotype (e.g., a Class with
+        # stereotype "enumeration" transforms as an enum).
+        #
+        # EA object types that have no UML model equivalent return nil and
+        # are skipped during transformation:
+        #
+        #   Text           — diagram text annotation box. A rendering hint,
+        #                    not a model element. Currently dropped; its
+        #                    content is not preserved in the UML document.
+        #                    (Faithful mapping to UML Comment is pending a
+        #                    `comments` collection on Package.)
+        #
+        #   ProxyConnector — EA-internal stub representing a connector that
+        #                    crosses package boundaries. Structural plumbing
+        #                    with no UML equivalent. Dropped.
+        #
+        #   Note           — diagram note. Same situation as Text: rendering
+        #                    hint, not a model element. Dropped.
+        #
+        # @return [Symbol, nil] Registry key or nil if not a UML model element
+        def transformer_type
+          if enumeration? || stereotype_is?("enumeration")
+            :enumeration
+          elsif data_type?
+            :data_type
+          elsif uml_class? || interface?
+            :class
+          elsif instance?
+            :instance
+          end
+        end
+
+        def stereotype_is?(expected)
+          return false unless stereotype
+
+          stereotype.downcase == expected
+        end
+
+        # @return [Integer] tpos for tree-position ordering
+        def sort_position
+          tpos || 0
+        end
+      end
+    end
+  end
+end

data/lib/ea/qea/models/ea_object_constraint.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Ea
+  module Qea
+    module Models
+      # EA Object Constraint model
+      #
+      # Represents OCL constraints attached to UML objects in the
+      # t_objectconstraint table.
+      #
+      # @example Create from database row
+      #   row = {
+      #     "Object_ID" => 4,
+      #     "Constraint" => "count(self.legalConstraints) >= 1",
+      #     "ConstraintType" => "Invariant",
+      #     "Weight" => "0.0",
+      #     "Notes" => nil,
+      #     "Status" => "Approved"
+      #   }
+      #   constraint = EaObjectConstraint.from_db_row(row)
+      class EaObjectConstraint < BaseModel
+        attribute :constraint_id, :integer
+        attribute :ea_object_id, :integer
+        attribute :constraint, :string
+        attribute :constraint_type, :string
+        attribute :weight, :float
+        attribute :notes, :string
+        attribute :status, :string
+
+        # @return [Symbol] Primary key column name
+        def self.primary_key_column
+          :constraint_id
+        end
+
+        # @return [String] Database table name
+        def self.table_name
+          "t_objectconstraint"
+        end
+
+
+        COLUMN_MAP = {
+          "ConstraintID" => :constraint_id,
+          "Object_ID" => :ea_object_id,
+          "ConstraintType" => :constraint_type,
+        }.freeze
+
+        def self.column_map
+          COLUMN_MAP
+        end
+      end
+    end
+  end
+end

data/lib/ea/qea/models/ea_object_property.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+module Ea
+  module Qea
+    module Models
+      # EA Object Property model
+      #
+      # Represents object-level properties (custom key-value metadata)
+      # in the t_objectproperties table. These are metadata properties
+      # specific to GML/XML Schema encoding.
+      #
+      # @example Create from database row
+      #   row = {
+      #     "PropertyID" => 1,
+      #     "Object_ID" => 684,
+      #     "Property" => "isCollection",
+      #     "Value" => "false",
+      #     "Notes" => "Values: true,false...",
+      #     "ea_guid" => "{GUID}"
+      #   }
+      #   property = EaObjectProperty.from_db_row(row)
+      class EaObjectProperty < BaseModel
+        attribute :property_id, :integer
+        attribute :ea_object_id, :integer
+        attribute :property, :string
+        attribute :value, :string
+        attribute :notes, :string
+        attribute :ea_guid, :string
+
+        # @return [Symbol] Primary key column name
+        def self.primary_key_column
+          :property_id
+        end
+
+        # @return [String] Database table name
+        def self.table_name
+          "t_objectproperties"
+        end
+
+
+        COLUMN_MAP = {
+          "PropertyID" => :property_id,
+          "Object_ID" => :ea_object_id,
+        }.freeze
+
+        def self.column_map
+          COLUMN_MAP
+        end
+
+        # Get property name
+        #
+        # @return [String, nil] Property name
+        def name
+          property
+        end
+
+        # Get property value as string
+        #
+        # @return [String, nil] Property value
+        def property_value
+          value
+        end
+
+        # Parse boolean value
+        #
+        # @return [Boolean, nil] Boolean value if parseable, nil otherwise
+        def boolean_value
+          return nil if value.nil?
+
+          case value.downcase
+          when "true", "1", "yes"
+            true
+          when "false", "0", "no"
+            false
+          end
+        end
+
+        # Check if property is boolean type
+        #
+        # @return [Boolean] true if value is boolean
+        def boolean?
+          !boolean_value.nil?
+        end
+      end
+    end
+  end
+end

data/lib/ea/qea/models/ea_object_type.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Ea
+  module Qea
+    module Models
+      # Represents an object type definition from t_objecttypes table
+      #
+      # This table provides reference data for object/class types available
+      # in EA. These define what kinds of UML elements can be created.
+      #
+      # @example
+      #   object_type = EaObjectType.new
+      #   object_type.object_type #=> "Class"
+      #   object_type.description #=> "UML Class"
+      #   object_type.design_object? #=> false
+      class EaObjectType < BaseModel
+        attribute :object_type, Lutaml::Model::Type::String
+        attribute :description, Lutaml::Model::Type::String
+        attribute :designobject, Lutaml::Model::Type::Integer
+        attribute :imageid, Lutaml::Model::Type::Integer
+
+        def self.table_name
+          "t_objecttypes"
+        end
+
+        # Primary key is Object_Type (text)
+        def self.primary_key_column
+          "Object_Type"
+        end
+
+        # Friendly name for object type
+        # @return [String]
+        def name
+          object_type
+        end
+
+        # Check if this is a design object
+        # @return [Boolean]
+        def design_object?
+          designobject == 1
+        end
+
+        # Alias for readability
+        alias design_object designobject
+        alias image_id imageid
+
+        # Check if this is a Class type
+        # @return [Boolean]
+        def class_type?
+          object_type == "Class"
+        end
+
+        # Check if this is an Interface type
+        # @return [Boolean]
+        def interface_type?
+          object_type == "Interface"
+        end
+
+        # Check if this is a Package type
+        # @return [Boolean]
+        def package_type?
+          object_type == "Package"
+        end
+
+        # Check if this is an Actor type
+        # @return [Boolean]
+        def actor_type?
+          object_type == "Actor"
+        end
+      end
+    end
+  end
+end