tormenta20 0.2.11 → 0.2.12

data/src/json/livros/t20_eja.json

@@ -0,0 +1,5 @@
+{
+  "id": "t20_eja",
+  "nome": "Tormenta 20 - Edição Jogo do Ano",
+  "nome_curto": "T20 - EJA"
+}

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

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Tormenta20
+  module Concerns
+    # Mixin that gives any gem model access to its book/page reference.
+    #
+    # Methods are lazy-loaded: the database is queried on the first call
+    # and the result is memoized for the lifetime of the instance.
+    #
+    # @example
+    #   guerreiro = Tormenta20.classes.find("guerreiro")
+    #   guerreiro.book_reference  # => "T20 - EJA, p. 56"
+    #   guerreiro.page            # => 56
+    #   guerreiro.book            # => "T20 - EJA"
+    #   guerreiro.full_book       # => "Tormenta 20 - Edição Jogo do Ano"
+    module BookReferenceable
+      # "T20 - EJA, p. 215" — nil se não houver entrada no índice.
+      def book_reference
+        entry = _indice_entry
+        return nil unless entry
+
+        "#{entry.livro.nome_curto}, p. #{entry.pagina}"
+      end
+
+      # Número da página (Integer) — nil se não indexado.
+      def page
+        _indice_entry&.pagina
+      end
+
+      # Nome curto do livro (String) — nil se não indexado.
+      def book
+        _indice_entry&.livro&.nome_curto
+      end
+
+      # Nome completo do livro (String) — nil se não indexado.
+      def full_book
+        _indice_entry&.livro&.nome
+      end
+
+      private
+
+      def _indice_entry
+        # Memoize por instância; reset se o id mudar.
+        return @_indice_entry if defined?(@_indice_entry)
+
+        @_indice_entry = Models::IndiceRemissivo
+          .includes(:livro)
+          .find_by(tabela: self.class.table_name, registro_id: id.to_s)
+      end
+    end
+  end
+end

data/src/ruby/tormenta20/database.rb

@@ -125,6 +125,7 @@ module Tormenta20
           pool: 5,
           timeout: 5000
         )
+        Models::Base.logger = nil
 
         @connected = true
       end

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

@@ -14,6 +14,8 @@ module Tormenta20
     # @abstract Subclass and set table_name to create a new model
     class Base < ActiveRecord::Base
       self.abstract_class = true
+
+      include Concerns::BookReferenceable
     end
   end
 end

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

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require "active_record"
+
+module Tormenta20
+  module Models
+    # Entrada do índice remissivo de um livro.
+    #
+    # Cada linha representa um termo do índice associado a uma página.
+    # Os campos +tabela+ e +registro_id+ são opcionais e preenchidos quando
+    # o termo é vinculado a um registro concreto de outra tabela da gem.
+    #
+    # @example Buscar página de "Guerreiro" no T20 EJA
+    #   Tormenta20::Models::IndiceRemissivo
+    #     .where(livro_id: "t20_eja", tabela: "classes", registro_id: "guerreiro")
+    #     .pluck(:pagina)
+    #
+    # @example Buscar todas as entradas de um livro que mencionam "Magia"
+    #   Tormenta20::Models::IndiceRemissivo
+    #     .where(livro_id: "t20_eja")
+    #     .where("termo LIKE ?", "%Magia%")
+    class IndiceRemissivo < Base
+      self.table_name = "indice_remissivo"
+      self.primary_key = "id"
+
+      belongs_to :livro,
+                 class_name: "Tormenta20::Models::Livro",
+                 foreign_key: "livro_id"
+
+      validates :livro_id, presence: true
+      validates :termo,    presence: true
+      validates :pagina,   presence: true, numericality: { only_integer: true, greater_than: 0 }
+
+      # Scopes
+      scope :do_livro,      ->(livro_id)    { where(livro_id: livro_id) }
+      scope :para_tabela,   ->(tabela)      { where(tabela: tabela) }
+      scope :associados,                    -> { where.not(registro_id: nil) }
+      scope :nao_associados,                -> { where(registro_id: nil) }
+      scope :buscar_termo,  ->(q)           { where("termo LIKE ?", "%#{q}%") }
+
+      def to_h
+        {
+          id:          id,
+          livro_id:    livro_id,
+          termo:       termo,
+          pagina:      pagina,
+          tabela:      tabela,
+          registro_id: registro_id
+        }.compact
+      end
+
+      def associado?
+        registro_id.present?
+      end
+    end
+  end
+end

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

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require "active_record"
+
+module Tormenta20
+  module Models
+    class Livro < Base
+      self.table_name = "livros"
+
+      has_many :indice_remissivo_entries,
+               class_name: "Tormenta20::Models::IndiceRemissivo",
+               foreign_key: "livro_id",
+               dependent: :destroy
+
+      validates :id,         presence: true, uniqueness: true
+      validates :nome,       presence: true
+      validates :nome_curto, presence: true
+
+      def to_h
+        {
+          id:         id,
+          nome:       nome,
+          nome_curto: nome_curto
+        }
+      end
+    end
+  end
+end

data/src/ruby/tormenta20/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tormenta20
-  VERSION = "0.2.11"
+  VERSION = "0.2.12"
 end

data/src/ruby/tormenta20.rb

@@ -6,6 +6,9 @@ require "sqlite3"
 
 require_relative "tormenta20/database"
 
+# Load concerns before models
+require_relative "tormenta20/concerns/book_referenceable"
+
 # Load base model first, then other models
 require_relative "tormenta20/models/base"
 Dir["#{__dir__}/tormenta20/models/*.rb"].each { |file| require file unless file.include?("base") }
@@ -182,6 +185,20 @@ module Tormenta20
       Models::Condicao
     end
 
+    # Acesso aos livros cadastrados.
+    #
+    # @return [Class] Tormenta20::Models::Livro
+    def livros
+      Models::Livro
+    end
+
+    # Acesso ao índice remissivo.
+    #
+    # @return [Class] Tormenta20::Models::IndiceRemissivo
+    def indice_remissivo
+      Models::IndiceRemissivo
+    end
+
     # @!endgroup
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tormenta20
 version: !ruby/object:Gem::Version
-  version: 0.2.11
+  version: 0.2.12
 platform: ruby
 authors:
 - LuanGB
@@ -73,14 +73,18 @@ files:
 - docs/armaduras.md
 - docs/armas.md
 - docs/classes.md
+- docs/condicoes.md
 - docs/divindades.md
 - docs/escudos.md
+- docs/indice_remissivo.md
 - docs/itens.md
+- docs/livros.md
 - docs/magias.md
 - docs/materiais_especiais.md
 - docs/melhorias.md
 - docs/origens.md
 - docs/poderes.md
+- docs/racas.md
 - docs/regras.md
 - examples/database_usage.rb
 - exe/tormenta20
@@ -329,6 +333,7 @@ files:
 - src/json/equipamentos/municoes/flechas.json
 - src/json/equipamentos/municoes/pedras.json
 - src/json/equipamentos/municoes/virotes.json
+- src/json/indice_remissivo/t20_eja.json
 - src/json/itens_superiores/materiais_especiais/aco_rubi.json
 - src/json/itens_superiores/materiais_especiais/adamante.json
 - src/json/itens_superiores/materiais_especiais/gelo_eterno.json
@@ -364,6 +369,7 @@ files:
 - src/json/itens_superiores/melhorias/geral/discreto.json
 - src/json/itens_superiores/melhorias/geral/macabro.json
 - src/json/itens_superiores/melhorias/geral/material_especial.json
+- src/json/livros/t20_eja.json
 - src/json/magias/abencoar_alimentos.json
 - src/json/magias/acalmar_animal.json
 - src/json/magias/adaga_mental.json
@@ -1244,6 +1250,7 @@ files:
 - src/json/regras/venenos.json
 - src/python/__init__.py
 - src/ruby/tormenta20.rb
+- src/ruby/tormenta20/concerns/book_referenceable.rb
 - src/ruby/tormenta20/database.rb
 - src/ruby/tormenta20/models/arma.rb
 - src/ruby/tormenta20/models/armadura.rb
@@ -1252,7 +1259,9 @@ files:
 - src/ruby/tormenta20/models/condicao.rb
 - src/ruby/tormenta20/models/divindade.rb
 - src/ruby/tormenta20/models/escudo.rb
+- src/ruby/tormenta20/models/indice_remissivo.rb
 - src/ruby/tormenta20/models/item.rb
+- src/ruby/tormenta20/models/livro.rb
 - src/ruby/tormenta20/models/magia.rb
 - src/ruby/tormenta20/models/material_especial.rb
 - src/ruby/tormenta20/models/melhoria.rb