tormenta20 0.2.22 → 1.0.0

data/src/ruby/tormenta20/concerns/livro_scoped.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Tormenta20
+  module Concerns
+    # Mixin that gives any gem model with a +livro_id+ column access to its
+    # source book and a scope to filter by it.
+    #
+    # Distinct from {BookReferenceable}: that concern looks up a record's page
+    # number via the (sparse) printed índice remissivo, while +livro_id+ is
+    # the authoritative "book this record was published in" column, present
+    # on every content table and defaulting to +"t20_eja"+.
+    #
+    # @example
+    #   Tormenta20.classes.do_livro("t20_eja").all
+    #   Tormenta20.classes.first.livro.nome_curto  # => "T20 - EJA"
+    module LivroScoped
+      extend ActiveSupport::Concern
+
+      included do
+        belongs_to :livro, class_name: "Tormenta20::Models::Livro", foreign_key: "livro_id", optional: true
+
+        scope :do_livro, ->(livro_id) { where(livro_id: livro_id) }
+      end
+    end
+  end
+end

data/src/ruby/tormenta20/models/acessorio_magico.rb

@@ -8,7 +8,7 @@ module Tormenta20
     #
     # @example
     #   AcessorioMagico.menores.all
-    #   AcessorioMagico.find_by(id: "anel_de_protecao").efeito
+    #   AcessorioMagico.find_by(id: "anel_de_protecao").effects
     #
     # @!attribute [rw] id
     #   @return [String] Unique identifier
@@ -39,15 +39,12 @@ module Tormenta20
       scope :maiores, -> { where(categoria: "maior") }
       # @!endgroup
 
-      # Returns the parsed effect hash, handling both raw JSON strings and pre-parsed hashes.
-      # @return [Hash] Effect data, or +{}+ on parse failure
-      def efeito
-        raw = read_attribute(:efeito)
-        return {} if raw.blank?
-
-        raw.is_a?(Hash) ? raw : JSON.parse(raw)
-      rescue JSON::ParserError
-        {}
+      def to_h
+        {
+          id: id, name: name, categoria: categoria, preco: preco,
+          roll_min: roll_min, roll_max: roll_max,
+          description: description, effects: effects
+        }.compact
       end
     end
   end

data/src/ruby/tormenta20/models/ameaca.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require "active_record"
+
+module Tormenta20
+  module Models
+    # Monster and enemy stat blocks from Tormenta20.
+    #
+    # @example
+    #   Tormenta20.ameacas.where(grupo: "masmorras").order(:nd)
+    #   Tormenta20.ameacas.find("basilisco")
+    class Ameaca < Base
+      self.table_name = "ameacas"
+
+      validates :id, presence: true, uniqueness: true
+      validates :name, presence: true
+      validates :nd, presence: true
+      validates :grupo, presence: true
+
+      scope :by_grupo, ->(g) { where(grupo: g) }
+      scope :by_nd, ->(n) { where(nd: n) }
+      scope :masmorras,        -> { where(grupo: "masmorras") }
+      scope :ermos,            -> { where(grupo: "ermos") }
+      scope :puristas,         -> { where(grupo: "puristas") }
+      scope :reino_dos_mortos, -> { where(grupo: "reino_dos_mortos") }
+      scope :duyshidakk,       -> { where(grupo: "duyshidakk") }
+      scope :sszzaazitas,      -> { where(grupo: "sszzaazitas") }
+      scope :trolls_nobres,    -> { where(grupo: "trolls_nobres") }
+      scope :dragoes,          -> { where(grupo: "dragoes") }
+      scope :tormenta,         -> { where(grupo: "tormenta") }
+      scope :avatares,         -> { where(grupo: "avatares") }
+
+      def atributos
+        { for: self[:for], des: des, con: con, int: self[:int], sab: sab, car: car }
+      end
+
+      def to_h
+        {
+          id: id,
+          name: name,
+          nd: nd,
+          tipo: tipo,
+          subtipo: subtipo,
+          tamanho: tamanho,
+          grupo: grupo,
+          pv: pv,
+          defesa: defesa,
+          atributos: atributos,
+          iniciativa: iniciativa,
+          deslocamento: deslocamento,
+          salvaguardas: salvaguardas,
+          percepcao: percepcao,
+          visao: visao,
+          ataques: ataques,
+          poderes_especiais: poderes_especiais,
+          imunidades: imunidades,
+          resistencias: resistencias,
+          vulnerabilidades: vulnerabilidades,
+          reducao_de_dano: reducao_de_dano,
+          cura_acelerada: cura_acelerada,
+          resistencia_a_magia: resistencia_a_magia,
+          pericias: pericias,
+          equipamento: equipamento,
+          tesouro: tesouro,
+          pm: pm,
+          description: description,
+          familiar: familiar,
+          parceiro: parceiro
+        }.compact
+      end
+    end
+  end
+end

data/src/ruby/tormenta20/models/arma_magica_especifica.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require "active_record"
+
+module Tormenta20
+  module Models
+    # Named specific magic weapons from Tormenta20 (Cap. 8, Tabela 8-9).
+    #
+    # @example
+    #   Tormenta20.armas_magicas.find("cajado_do_poder")
+    #   Tormenta20.armas_magicas.order(:preco)
+    class ArmaMagicaEspecifica < Base
+      self.table_name = "armas_magicas_especificas"
+
+      validates :id, presence: true, uniqueness: true
+      validates :name, presence: true
+
+      scope :by_base, ->(w) { where(base_weapon: w) }
+
+      def to_h
+        {
+          id: id,
+          name: name,
+          base_weapon: base_weapon,
+          preco: preco,
+          description: description,
+          effects: effects
+        }.compact
+      end
+    end
+  end
+end

data/src/ruby/tormenta20/models/armadura_magica_especifica.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require "active_record"
+
+module Tormenta20
+  module Models
+    # Named specific magic armors and shields from Tormenta20 (Cap. 8, Tabela 8-11).
+    #
+    # @example
+    #   Tormenta20.armaduras_magicas.where(subtipo: "escudo")
+    #   Tormenta20.armaduras_magicas.find("cota_elfica")
+    class ArmaduraMagicaEspecifica < Base
+      self.table_name = "armaduras_magicas_especificas"
+
+      validates :id, presence: true, uniqueness: true
+      validates :name, presence: true
+      validates :subtipo, inclusion: { in: %w[armadura escudo] }
+
+      scope :armaduras, -> { where(subtipo: "armadura") }
+      scope :escudos,   -> { where(subtipo: "escudo") }
+
+      def to_h
+        {
+          id: id,
+          name: name,
+          subtipo: subtipo,
+          base_item: base_item,
+          preco: preco,
+          description: description,
+          effects: effects
+        }.compact
+      end
+    end
+  end
+end

data/src/ruby/tormenta20/models/artefato.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require "active_record"
+
+module Tormenta20
+  module Models
+    # Artifacts — unique, extremely powerful magic items from Tormenta20 (Cap. 8, pp. 350–353).
+    #
+    # @example
+    #   Tormenta20.artefatos.all
+    #   Tormenta20.artefatos.find("espada_deus")
+    class Artefato < Base
+      self.table_name = "artefatos"
+
+      validates :id, presence: true, uniqueness: true
+      validates :name, presence: true
+
+      def to_h
+        { id: id, name: name, description: description, effects: effects }.compact
+      end
+    end
+  end
+end

data/src/ruby/tormenta20/models/base.rb

@@ -13,12 +13,15 @@ module Tormenta20
     #
     # Every concrete model adds {Concerns::BookReferenceable}, which provides
     # the {Concerns::BookReferenceable#book_reference} method for sourcebook
-    # page lookup.
+    # page lookup, and {Concerns::LivroScoped}, which provides the +livro+
+    # association and +.do_livro+ scope for filtering by source book.
     #
     # @abstract Subclass and set +table_name+ to create a new model
     #
     # @!attribute [rw] id
     #   @return [String] Unique string identifier (e.g. +"guerreiro"+, +"espada_longa"+)
+    # @!attribute [rw] livro_id
+    #   @return [String] Slug of the sourcebook this record was published in (default +"t20_eja"+)
     # @!attribute [r] created_at
     #   @return [Time] Record creation timestamp
     # @!attribute [r] updated_at
@@ -27,6 +30,7 @@ module Tormenta20
       self.abstract_class = true
 
       include Concerns::BookReferenceable
+      include Concerns::LivroScoped
 
       # Raised when any write operation is attempted on the Tormenta20 database.
       # The database is read-only by design — it ships as pre-built data.
@@ -38,8 +42,17 @@ module Tormenta20
 
       # @!group Read-only enforcement
 
+      class << self
+        # @return [Boolean] true while {Tormenta20::Seeder} is populating a fresh database.
+        #   Internal escape hatch: seeding is a legitimate write path, distinct from a
+        #   consumer of the built gem mutating data.
+        def seeding?
+          Thread.current[:tormenta20_seeding] == true
+        end
+      end
+
       def readonly?
-        true
+        !self.class.seeding?
       end
 
       def destroy

data/src/ruby/tormenta20/models/base_tipo.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require "active_record"
+
+module Tormenta20
+  module Models
+    # A Tipo de Base (headquarters type) in Tormenta20.
+    #
+    # Represents the physical nature of a group's headquarters (Esconderijo,
+    # Fortificação, Móvel, Residência, Centro de Poder, Empreendimento) and the
+    # passive bonuses it grants its residents. Only catalog data lives here — an
+    # actual base built by a group (with a chosen type, porte, cômodos, and
+    # mobílias) is campaign state, not gem content.
+    #
+    # @example
+    #   Tormenta20.bases_tipos.find("fortificacao")
+    class BaseTipo < Base
+      self.table_name = "bases_tipos"
+
+      validates :id, presence: true, uniqueness: true
+      validates :name, presence: true
+
+      def to_h
+        {
+          id: id,
+          name: name,
+          description: description,
+          effects: effects || []
+        }.compact
+      end
+    end
+  end
+end

data/src/ruby/tormenta20/models/classe_variante.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require "active_record"
+
+module Tormenta20
+  module Models
+    # Model representing a Classe Variante (variant class) in Tormenta20.
+    #
+    # A variant class is a specialized version of a base class (e.g. Duelista
+    # is a Bucaneiro variant). It is stored as a diff over the base class: the
+    # +diffs+ array lists, per level, which base-class abilities are removed
+    # and which new ones are added. Consumers must resolve the diff against
+    # the base {Classe} record to build the final character sheet.
+    #
+    # @example
+    #   variante = Tormenta20.classes_variantes.find("duelista")
+    #   variante.base_classe #=> the Bucaneiro Classe record
+    #   variante.diffs       #=> [{ "nivel" => 1, "remove" => [...], "adiciona" => [...] }, ...]
+    class ClasseVariante < Base
+      self.table_name = "classes_variantes"
+
+      belongs_to :base_classe, class_name: "Tormenta20::Models::Classe", foreign_key: "base_class_id"
+
+      validates :id, presence: true, uniqueness: true
+      validates :name, presence: true
+      validates :base_class_id, presence: true
+
+      scope :by_base, ->(class_id) { where(base_class_id: class_id) }
+
+      def to_h
+        {
+          id: id,
+          name: name,
+          base_class_id: base_class_id,
+          description: description,
+          diffs: diffs
+        }.compact
+      end
+    end
+  end
+end

data/src/ruby/tormenta20/models/comodo.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require "active_record"
+
+module Tormenta20
+  module Models
+    # A Cômodo (headquarters room) in Tormenta20.
+    #
+    # A catalog of rooms a group can build inside their base, each granting a
+    # passive bonus to residents. Some have a +prerequisito+ (e.g. another cômodo,
+    # or a minimum porte). Only catalog data lives here — see {BaseTipo}.
+    #
+    # @example
+    #   Tormenta20.comodos.find("biblioteca")
+    class Comodo < Base
+      self.table_name = "comodos"
+
+      validates :id, presence: true, uniqueness: true
+      validates :name, presence: true
+
+      def to_h
+        {
+          id: id,
+          name: name,
+          description: description,
+          effects: effects || [],
+          prerequisito: prerequisito
+        }.compact
+      end
+    end
+  end
+end

data/src/ruby/tormenta20/models/complicacao.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require "active_record"
+
+module Tormenta20
+  module Models
+    # A Complicação (character complication) in Tormenta20.
+    #
+    # Chosen at character creation: the player accepts a mechanical drawback ({#effects})
+    # in exchange for freely picking any one general power whose prerequisites they meet
+    # (not a fixed grant tied to the complication — the gem doesn't model that choice,
+    # it belongs to the consumer's character-creation flow). +categoria+ is +"geral"+ for
+    # complications any character can take, or a class id (e.g. +"guerreiro"+) for
+    # complications specific to that class.
+    #
+    # @example
+    #   Tormenta20.complicacoes.gerais
+    #   Tormenta20.complicacoes.by_categoria("guerreiro")
+    class Complicacao < Base
+      self.table_name = "complicacoes"
+
+      validates :id, presence: true, uniqueness: true
+      validates :name, presence: true
+      validates :categoria, presence: true
+
+      scope :gerais, -> { where(categoria: "geral") }
+      scope :by_categoria, ->(categoria) { where(categoria: categoria) }
+
+      def to_h
+        {
+          id: id,
+          name: name,
+          description: description,
+          categoria: categoria,
+          effects: effects || []
+        }.compact
+      end
+    end
+  end
+end

data/src/ruby/tormenta20/models/construcao_dominio.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require "active_record"
+
+module Tormenta20
+  module Models
+    # A Construção de Domínio (domain building) in Tormenta20.
+    #
+    # A catalog of buildings a regent can erect in their domain (Cap. 4 "Domínios"),
+    # each with a cost in Lingotes de Ouro (LO) and a mechanical benefit. Only catalog
+    # data lives here — an actual domain's characteristics (level, corte, popularidade,
+    # buildings erected) are campaign state, not gem content. See also {BaseTipo} for
+    # the analogous pattern applied to group headquarters.
+    #
+    # @example
+    #   Tormenta20.construcoes_dominio.by_categoria("religiao")
+    class ConstrucaoDominio < Base
+      self.table_name = "construcoes_dominio"
+
+      validates :id, presence: true, uniqueness: true
+      validates :name, presence: true
+      validates :categoria, presence: true, inclusion: { in: %w[nobreza guerra enganacao religiao misticismo] }
+
+      scope :by_categoria, ->(categoria) { where(categoria: categoria) }
+
+      def to_h
+        {
+          id: id,
+          name: name,
+          description: description,
+          categoria: categoria,
+          custo: custo,
+          effects: effects || [],
+          prerequisito: prerequisito
+        }.compact
+      end
+    end
+  end
+end

data/src/ruby/tormenta20/models/distincao.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require "active_record"
+
+module Tormenta20
+  module Models
+    # Model representing a Distinção in Tormenta20.
+    #
+    # A distinction ties a character to an organization, philosophy, or people
+    # of Arton. It has three parts: admissão (narrative requirement), marca
+    # (an ability granted automatically on admission), and a set of exclusive
+    # powers. The powers themselves live in {Poder} (+type: "poder_distincao"+,
+    # +distincao_id+ pointing back here) — not duplicated on this model.
+    #
+    # @example Find a distinction and its powers
+    #   Tormenta20.distincoes.find("cavaleiro_do_corvo")
+    #   Tormenta20.poderes.where(distincao_id: "cavaleiro_do_corvo")
+    class Distincao < Base
+      self.table_name = "distincoes"
+
+      has_many :poderes, class_name: "Tormenta20::Models::Poder"
+
+      validates :id, presence: true, uniqueness: true
+      validates :name, presence: true
+
+      def to_h
+        {
+          id: id,
+          name: name,
+          description: description,
+          admissao: admissao,
+          marca_nome: marca_nome,
+          marca_descricao: marca_descricao,
+          nivel_minimo: nivel_minimo
+        }.compact
+      end
+    end
+  end
+end

data/src/ruby/tormenta20/models/divindade.rb

@@ -59,6 +59,16 @@ module Tormenta20
       #   @return [ActiveRecord::Relation<Divindade>]
       scope :by_energy, ->(e) { where(energy: e) }
 
+      # @!method maiores
+      #   Filter major (greater) deities.
+      #   @return [ActiveRecord::Relation<Divindade>]
+      scope :maiores, -> { where(rank: "maior") }
+
+      # @!method menores
+      #   Filter minor (lesser) deities (Deuses de Arton, Cap. 3).
+      #   @return [ActiveRecord::Relation<Divindade>]
+      scope :menores, -> { where(rank: "menor") }
+
       # @!endgroup
 
       # Get races that typically worship this deity.
@@ -90,7 +100,10 @@ module Tormenta20
           preferred_weapon: preferred_weapon,
           devotees: devotees,
           granted_powers: granted_powers,
-          obligations_restrictions: obligations_restrictions
+          obligations_restrictions: obligations_restrictions,
+          rank: rank,
+          natureza: natureza,
+          status_divino: status_divino
         }.compact
       end
     end

data/src/ruby/tormenta20/models/encantamento.rb

@@ -21,11 +21,13 @@ module Tormenta20
 
       validates :id, presence: true, uniqueness: true
       validates :name, presence: true
-      validates :categoria, presence: true, inclusion: { in: %w[arma armadura_escudo] }
+      validates :categoria, presence: true, inclusion: { in: %w[arma armadura esoterico acessorio] }
 
       scope :armas, -> { where(categoria: "arma") }
-      scope :armaduras_escudos, -> { where(categoria: "armadura_escudo") }
+      scope :armaduras_escudos, -> { where(categoria: "armadura") }
       scope :escudo_only, -> { where(escudo_only: true) }
+      scope :maldicoes, -> { where(maldicao: true) }
+      scope :nao_maldicoes, -> { where(maldicao: [false, nil]) }
 
       def to_h
         {
@@ -35,8 +37,9 @@ module Tormenta20
           categoria: categoria,
           escudo_only: escudo_only == 1,
           conta_como_dois: conta_como_dois == 1,
+          maldicao: maldicao == 1,
           prerequisitos: prerequisitos,
-          efeito: efeito
+          effects: effects
         }.compact
       end
     end

data/src/ruby/tormenta20/models/esoterico_magico.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require "active_record"
+
+module Tormenta20
+  module Models
+    # Magic esoteric implements (staffs, wands, holy symbols) used by spellcasters.
+    #
+    # @example
+    #   EsotericoMagico.menores.all
+    #   EsotericoMagico.find_by(id: "cajado_do_poder").effects
+    #
+    # @!attribute [rw] id
+    #   @return [String] Unique identifier
+    # @!attribute [rw] name
+    #   @return [String] Item name
+    # @!attribute [rw] categoria
+    #   @return [String] Power tier: +"menor"+, +"medio"+, or +"maior"+
+    # @!attribute [rw] preco
+    #   @return [Integer, nil] Price in tibares
+    # @!attribute [rw] roll_min
+    #   @return [Integer, nil] Minimum roll on random loot table
+    # @!attribute [rw] roll_max
+    #   @return [Integer, nil] Maximum roll on random loot table
+    # @!attribute [rw] description
+    #   @return [String, nil] Item description
+    class EsotericoMagico < Base
+      self.table_name = "esotericos_magicos"
+
+      # @!group Scopes
+      # @!method menores
+      #   @return [ActiveRecord::Relation] Minor-tier esoterics
+      scope :menores, -> { where(categoria: "menor") }
+      # @!method medios
+      #   @return [ActiveRecord::Relation] Medium-tier esoterics
+      scope :medios,  -> { where(categoria: "medio") }
+      # @!method maiores
+      #   @return [ActiveRecord::Relation] Major-tier esoterics
+      scope :maiores, -> { where(categoria: "maior") }
+      # @!endgroup
+
+      def to_h
+        {
+          id: id, name: name, categoria: categoria, preco: preco,
+          roll_min: roll_min, roll_max: roll_max,
+          description: description, effects: effects
+        }.compact
+      end
+    end
+  end
+end

data/src/ruby/tormenta20/models/item_liturgico.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require "active_record"
+
+module Tormenta20
+  module Models
+    # Named magic item tied to a specific deity (Deuses de Arton, Cap. 1).
+    #
+    # Liturgical items (weapons, armors or accessories) only reach their full
+    # potential — or only work at all — in the hands of a devotee of the
+    # associated deity. They can span multiple item categories, so `deities`
+    # is a JSON array instead of a rigid foreign key.
+    #
+    # @example
+    #   Tormenta20.itens_liturgicos.find("cilicio_vivo")
+    #   Tormenta20.itens_liturgicos.by_deity("aharadak")
+    class ItemLiturgico < Base
+      self.table_name = "itens_liturgicos"
+
+      validates :id, presence: true, uniqueness: true
+      validates :name, presence: true
+
+      scope :by_deity, ->(deity_id) { where("json_extract(deities, '$') LIKE ?", "%#{deity_id}%") }
+      scope :by_subtipo, ->(s) { where(subtipo: s) }
+
+      def to_h
+        {
+          id: id,
+          name: name,
+          deities: deities,
+          subtipo: subtipo,
+          base_item: base_item,
+          classificacao: classificacao,
+          preco: preco,
+          description: description,
+          effects: effects
+        }.compact
+      end
+    end
+  end
+end

data/src/ruby/tormenta20/models/mobilia.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require "active_record"
+
+module Tormenta20
+  module Models
+    # A Mobília (headquarters furniture) in Tormenta20.
+    #
+    # A catalog of furniture items that can be installed in a {Comodo} to grant an
+    # additional bonus. Some are restricted to a specific cômodo (+comodo_alvo+).
+    # Only catalog data lives here — see {BaseTipo}.
+    #
+    # @example
+    #   Tormenta20.mobilias.find("bar")
+    class Mobilia < Base
+      self.table_name = "mobilias"
+
+      validates :id, presence: true, uniqueness: true
+      validates :name, presence: true
+
+      def to_h
+        {
+          id: id,
+          name: name,
+          description: description,
+          effects: effects || [],
+          preco: preco,
+          comodo_alvo: comodo_alvo
+        }.compact
+      end
+    end
+  end
+end