tormenta20 0.2.11 → 0.2.12

data/docs/escudos.md

@@ -4,22 +4,22 @@ Acesso: `Tormenta20.escudos`
 
 ## Atributos
 
-| Atributo | Tipo | Descricao |
+| Atributo | Tipo | Descrição |
 |----------|------|-----------|
-| `id` | String | Identificador unico |
+| `id` | String | Identificador único |
 | `name` | String | Nome do escudo |
-| `price` | String | Preco |
-| `defense_bonus` | Integer | Bonus de defesa |
+| `price` | String | Preço |
+| `defense_bonus` | Integer | Bônus de defesa |
 | `armor_penalty` | Integer | Penalidade de armadura |
-| `weight` | String | Peso/espacos |
+| `weight` | String | Peso/espaços |
 | `properties` | Array | Propriedades especiais |
-| `description` | String | Descricao |
+| `description` | String | Descrição |
 
 ## Scopes (Filtros)
 
-Este modelo nao possui scopes especificos. Use queries ActiveRecord padrao.
+Este modelo não possui scopes específicos. Use queries ActiveRecord padrão.
 
-## Metodos de Instancia
+## Métodos de Instância
 
 ```ruby
 escudo = Tormenta20.escudos.first
@@ -35,15 +35,15 @@ Tormenta20.escudos.all.each do |e|
   puts "#{e.name}: +#{e.defense_bonus} Defesa, -#{e.armor_penalty} penalidade"
 end
 
-# Buscar escudo especifico
+# Buscar escudo específico
 escudo = Tormenta20.escudos.find("escudo_leve")
 puts escudo.name           # Nome
-puts escudo.defense_bonus  # Bonus de defesa
+puts escudo.defense_bonus  # Bônus de defesa
 puts escudo.armor_penalty  # Penalidade
 
-# Escudo com maior bonus
+# Escudo com maior bônus
 Tormenta20.escudos.order(defense_bonus: :desc).first
 
-# Escudos ordenados por preco
+# Escudos ordenados por preço
 Tormenta20.escudos.order(:price)
 ```

data/docs/indice_remissivo.md

@@ -0,0 +1,105 @@
+# Índice Remissivo
+
+Acesso: `Tormenta20.indice_remissivo`
+
+Armazena as entradas do índice remissivo de cada livro. Quando uma entrada possui `tabela` e `registro_id` preenchidos, ela fica vinculada a um registro concreto de outro model — o que permite que qualquer model retorne sua referência de livro e página via `BookReferenceable`.
+
+## Atributos
+
+| Atributo | Tipo | Descrição |
+|----------|------|-----------|
+| `id` | Integer | Chave primária (autoincremento) |
+| `livro_id` | String | ID do livro (FK para `livros`) |
+| `termo` | String | Termo como aparece no índice |
+| `pagina` | Integer | Número da página |
+| `tabela` | String / nil | Nome da tabela do registro vinculado |
+| `registro_id` | String / nil | ID do registro vinculado |
+
+## Scopes (Filtros)
+
+```ruby
+# Entradas de um livro específico
+Tormenta20.indice_remissivo.do_livro("t20_eja")
+
+# Entradas de uma tabela específica
+Tormenta20.indice_remissivo.para_tabela("classes")
+Tormenta20.indice_remissivo.para_tabela("poderes")
+
+# Entradas vinculadas a registros concretos
+Tormenta20.indice_remissivo.associados
+
+# Entradas sem vínculo a registro (termos gerais)
+Tormenta20.indice_remissivo.nao_associados
+
+# Busca por termo (LIKE)
+Tormenta20.indice_remissivo.buscar_termo("Fúria")
+Tormenta20.indice_remissivo.buscar_termo("magia")
+```
+
+## Métodos de Instância
+
+```ruby
+entrada = Tormenta20.indice_remissivo.first
+
+entrada.termo        # => "guerreiro (classe)"
+entrada.pagina       # => 64
+entrada.tabela       # => "classes"
+entrada.registro_id  # => "guerreiro"
+entrada.associado?   # => true
+
+entrada.livro.nome        # => "Tormenta 20 - Edição Jogo do Ano"
+entrada.livro.nome_curto  # => "T20 - EJA"
+
+entrada.to_h  # Hash completo (exclui nils com compact)
+```
+
+## Associações
+
+```ruby
+# A partir de um livro
+Tormenta20.livros.find("t20_eja").indice_remissivo_entries
+
+# A partir de qualquer model via BookReferenceable
+Tormenta20.classes.find("guerreiro").book_reference  # => "T20 - EJA, p. 64"
+```
+
+## BookReferenceable
+
+O concern `BookReferenceable` está incluído em todos os models e usa o índice remissivo para resolver as referências. A busca é feita por `(tabela, registro_id)` e o resultado é memoizado por instância.
+
+```ruby
+# Todos os métodos disponíveis em qualquer model
+record = Tormenta20.classes.find("arcanista")
+
+record.book_reference  # => "T20 - EJA, p. 36"   (nil se não indexado)
+record.page            # => 36
+record.book            # => "T20 - EJA"
+record.full_book       # => "Tormenta 20 - Edição Jogo do Ano"
+```
+
+## Exemplos
+
+```ruby
+# Páginas de todas as classes indexadas
+Tormenta20.indice_remissivo
+  .do_livro("t20_eja")
+  .para_tabela("classes")
+  .order(:pagina)
+  .each { |e| puts "#{e.registro_id}: p. #{e.pagina}" }
+
+# Termos que não estão vinculados a nenhum registro (regras gerais, locais, etc.)
+Tormenta20.indice_remissivo.nao_associados.buscar_termo("combate").each do |e|
+  puts "#{e.termo}: p. #{e.pagina}"
+end
+
+# Quantas entradas por tabela
+Tormenta20.indice_remissivo
+  .associados
+  .group(:tabela)
+  .count
+# => { "classes" => 14, "condicoes" => 30, "origens" => 35, ... }
+
+# Verificar se um registro está indexado
+Tormenta20.classes.find("guerreiro").page  # => 64
+Tormenta20.itens.first.page                # => nil (não indexado)
+```

data/docs/itens.md

@@ -4,14 +4,14 @@ Acesso: `Tormenta20.itens`
 
 ## Atributos
 
-| Atributo | Tipo | Descricao |
+| Atributo | Tipo | Descrição |
 |----------|------|-----------|
-| `id` | String | Identificador unico |
+| `id` | String | Identificador único |
 | `name` | String | Nome do item |
 | `category` | String | Categoria do item |
-| `price` | String | Preco |
-| `weight` | String | Peso/espacos |
-| `description` | String | Descricao |
+| `price` | String | Preço |
+| `weight` | String | Peso/espaços |
+| `description` | String | Descrição |
 | `effects` | Array | Efeitos do item |
 
 ## Scopes (Filtros)
@@ -24,7 +24,7 @@ Tormenta20.itens.by_category("ferramenta")
 Tormenta20.itens.by_category("vestuario")
 ```
 
-## Metodos de Instancia
+## Métodos de Instância
 
 ```ruby
 item = Tormenta20.itens.first
@@ -45,11 +45,11 @@ Tormenta20.itens.by_category("alquimico").each do |i|
   puts "#{i.name}: #{i.description}"
 end
 
-# Buscar item especifico
+# Buscar item específico
 item = Tormenta20.itens.find("corda")
 puts item.name         # Nome
-puts item.price        # Preco
-puts item.description  # Descricao
+puts item.price        # Preço
+puts item.description  # Descrição
 
 # Itens ordenados por nome
 Tormenta20.itens.order(:name)

data/docs/livros.md

@@ -0,0 +1,43 @@
+# Livros
+
+Acesso: `Tormenta20.livros`
+
+Registra os livros cujos índices remissivos estão disponíveis na gem. Usado internamente pelo concern `BookReferenceable` para resolver referências de página em todos os modelos.
+
+## Atributos
+
+| Atributo | Tipo | Descrição |
+|----------|------|-----------|
+| `id` | String | Slug do livro (ex: `"t20_eja"`) |
+| `nome` | String | Nome completo (ex: `"Tormenta 20 - Edição Jogo do Ano"`) |
+| `nome_curto` | String | Abreviação (ex: `"T20 - EJA"`) |
+
+## Associações
+
+```ruby
+livro = Tormenta20.livros.find("t20_eja")
+
+livro.indice_remissivo_entries        # Todas as entradas do índice deste livro
+livro.indice_remissivo_entries.count  # => 1098
+```
+
+## Exemplos
+
+```ruby
+# Listar livros disponíveis
+Tormenta20.livros.all.each do |l|
+  puts "#{l.id}: #{l.nome} (#{l.nome_curto})"
+end
+
+# Acessar entradas do índice de um livro
+t20 = Tormenta20.livros.find("t20_eja")
+t20.indice_remissivo_entries.para_tabela("classes").each do |e|
+  puts "#{e.termo}: p. #{e.pagina}"
+end
+```
+
+## Livros Disponíveis
+
+| ID | Nome | Abreviação | Entradas |
+|----|------|------------|----------|
+| `t20_eja` | Tormenta 20 - Edição Jogo do Ano | T20 - EJA | 1098+ |

data/docs/magias.md

@@ -4,58 +4,58 @@ Acesso: `Tormenta20.magias`
 
 ## Atributos
 
-| Atributo | Tipo | Descricao |
+| Atributo | Tipo | Descrição |
 |----------|------|-----------|
-| `id` | String | Identificador unico |
+| `id` | String | Identificador único |
 | `name` | String | Nome da magia |
 | `type` | String | Tipo: `arcana`, `divina`, `universal` |
-| `circle` | String | Circulo (1-5) |
+| `circle` | String | Círculo (1-5) |
 | `school` | String | Escola de magia |
-| `execution` | String | Tempo de execucao |
-| `execution_details` | String | Detalhes da execucao |
+| `execution` | String | Tempo de execução |
+| `execution_details` | String | Detalhes da execução |
 | `range` | String | Alcance |
-| `duration` | String | Duracao |
-| `duration_details` | String | Detalhes da duracao |
-| `description` | String | Descricao completa |
+| `duration` | String | Duração |
+| `duration_details` | String | Detalhes da duração |
+| `description` | String | Descrição completa |
 | `counterspell` | String | Contramagia |
-| `enhancements` | Array | Aprimoramentos disponiveis |
+| `enhancements` | Array | Aprimoramentos disponíveis |
 | `effects` | Array | Efeitos da magia |
 
 ### Atributos de Alvo
 
-| Atributo | Tipo | Descricao |
+| Atributo | Tipo | Descrição |
 |----------|------|-----------|
 | `target_amount` | Integer | Quantidade de alvos |
-| `target_up_to` | Boolean | Ate X alvos |
+| `target_up_to` | Boolean | Até X alvos |
 | `target_type` | String | Tipo de alvo |
 
 ### Atributos de Efeito
 
-| Atributo | Tipo | Descricao |
+| Atributo | Tipo | Descrição |
 |----------|------|-----------|
 | `effect` | String | Efeito principal |
 | `effect_shape` | String | Forma do efeito |
-| `effect_dimention` | String | Dimensao |
+| `effect_dimention` | String | Dimensão |
 | `effect_size` | String | Tamanho |
 | `effect_other_details` | String | Outros detalhes |
-| `area_effect` | String | Efeito de area |
-| `area_effect_details` | String | Detalhes da area |
+| `area_effect` | String | Efeito de área |
+| `area_effect_details` | String | Detalhes da área |
 
-### Atributos de Resistencia
+### Atributos de Resistência
 
-| Atributo | Tipo | Descricao |
+| Atributo | Tipo | Descrição |
 |----------|------|-----------|
-| `resistence_effect` | String | Efeito da resistencia |
-| `resistence_skill` | String | Pericia para resistencia |
+| `resistence_effect` | String | Efeito da resistência |
+| `resistence_skill` | String | Perícia para resistência |
 
 ### Atributos de Custo Extra
 
-| Atributo | Tipo | Descricao |
+| Atributo | Tipo | Descrição |
 |----------|------|-----------|
 | `extra_costs_material_component` | String | Componente material |
 | `extra_costs_material_cost` | String | Custo do componente |
 | `extra_costs_pm_debuff` | Integer | Debuff de PM |
-| `extra_costs_pm_sacrifice` | Integer | Sacrificio de PM |
+| `extra_costs_pm_sacrifice` | Integer | Sacrifício de PM |
 
 ## Scopes (Filtros)
 
@@ -68,42 +68,42 @@ Tormenta20.magias.universais   # Magias universais
 Tormenta20.magias.by_type("arcana")
 ```
 
-### Por Circulo
+### Por Círculo
 
 ```ruby
-Tormenta20.magias.by_circle("1")   # Magias do 1o circulo
-Tormenta20.magias.by_circle("5")   # Magias do 5o circulo
-Tormenta20.magias.do_circulo("3")  # Alias em portugues
+Tormenta20.magias.by_circle("1")   # Magias do 1º círculo
+Tormenta20.magias.by_circle("5")   # Magias do 5º círculo
+Tormenta20.magias.do_circulo("3")  # Alias em português
 ```
 
 ### Por Escola
 
 ```ruby
-Tormenta20.magias.by_school("evoc")    # Evocacao
-Tormenta20.magias.by_school("abjur")   # Abjuracao
-Tormenta20.magias.by_school("adiv")    # Adivinhacao
-Tormenta20.magias.by_school("conv")    # Convocacao
+Tormenta20.magias.by_school("evoc")    # Evocação
+Tormenta20.magias.by_school("abjur")   # Abjuração
+Tormenta20.magias.by_school("adiv")    # Adivinhação
+Tormenta20.magias.by_school("conv")    # Convocação
 Tormenta20.magias.by_school("encan")   # Encantamento
-Tormenta20.magias.by_school("ilus")    # Ilusao
+Tormenta20.magias.by_school("ilus")    # Ilusão
 Tormenta20.magias.by_school("necro")   # Necromancia
-Tormenta20.magias.by_school("trans")   # Transmutacao
-Tormenta20.magias.da_escola("evoc")    # Alias em portugues
+Tormenta20.magias.by_school("trans")   # Transmutação
+Tormenta20.magias.da_escola("evoc")    # Alias em português
 ```
 
 ### Combinando Filtros
 
 ```ruby
-# Magias arcanas do 3o circulo
+# Magias arcanas do 3º círculo
 Tormenta20.magias.arcanas.by_circle("3")
 
 # Magias divinas de necromancia
 Tormenta20.magias.divinas.by_school("necro")
 
-# Magias universais do 1o circulo de abjuracao
+# Magias universais do 1º círculo de abjuração
 Tormenta20.magias.universais.by_circle("1").by_school("abjur")
 ```
 
-## Metodos de Classe
+## Métodos de Classe
 
 ```ruby
 Tormenta20.magias.todas           # Todas as magias (alias para .all)
@@ -112,7 +112,7 @@ Tormenta20.magias.divinas_list    # Lista de divinas
 Tormenta20.magias.universais_list # Lista de universais
 ```
 
-## Metodos de Instancia
+## Métodos de Instância
 
 ```ruby
 magia = Tormenta20.magias.find("bola_de_fogo")
@@ -123,7 +123,7 @@ magia.target_info          # Hash com info do alvo
 magia.effect_details_info  # Hash com detalhes do efeito
 # => { shape: "esfera", size: "6m" }
 
-magia.resistence_info      # Hash com info de resistencia
+magia.resistence_info      # Hash com info de resistência
 # => { effect: "reduz", skill: "Reflexos" }
 
 magia.extra_costs_info     # Hash com custos extras
@@ -135,7 +135,7 @@ magia.to_h                 # Converte para Hash completo
 ## Exemplos
 
 ```ruby
-# Buscar magia especifica
+# Buscar magia específica
 bola_de_fogo = Tormenta20.magias.find("bola_de_fogo")
 puts bola_de_fogo.name        # => "Bola de Fogo"
 puts bola_de_fogo.circle      # => "3"
@@ -143,12 +143,12 @@ puts bola_de_fogo.school      # => "evoc"
 
 # Listar todas as magias de cura
 Tormenta20.magias.where("name LIKE ?", "%Cura%").each do |m|
-  puts "#{m.name} (#{m.type}, #{m.circle}o circulo)"
+  puts "#{m.name} (#{m.type}, #{m.circle}º círculo)"
 end
 
-# Magias arcanas ordenadas por circulo
+# Magias arcanas ordenadas por círculo
 Tormenta20.magias.arcanas.order(:circle, :name).each do |m|
-  puts "#{m.circle}o - #{m.name}"
+  puts "#{m.circle}º - #{m.name}"
 end
 
 # Contar magias por escola

data/docs/materiais_especiais.md

@@ -4,20 +4,20 @@ Acesso: `Tormenta20.materiais_especiais`
 
 ## Atributos
 
-| Atributo | Tipo | Descricao |
+| Atributo | Tipo | Descrição |
 |----------|------|-----------|
-| `id` | String | Identificador unico |
+| `id` | String | Identificador único |
 | `name` | String | Nome do material |
-| `description` | String | Descricao |
-| `applicable_to` | Array | Tipos de item aplicaveis |
-| `price_modifier` | String | Modificador de preco |
+| `description` | String | Descrição |
+| `applicable_to` | Array | Tipos de item aplicáveis |
+| `price_modifier` | String | Modificador de preço |
 | `effects` | Array | Efeitos do material |
 
 ## Scopes (Filtros)
 
-Este modelo nao possui scopes especificos. Use queries ActiveRecord padrao.
+Este modelo não possui scopes específicos. Use queries ActiveRecord padrão.
 
-## Metodos de Instancia
+## Métodos de Instância
 
 ```ruby
 material = Tormenta20.materiais_especiais.first
@@ -33,14 +33,14 @@ Tormenta20.materiais_especiais.all.each do |m|
   puts "#{m.name}: #{m.description}"
 end
 
-# Buscar material especifico
+# Buscar material específico
 adamante = Tormenta20.materiais_especiais.find("adamante")
 puts adamante.name            # => "Adamante"
-puts adamante.price_modifier  # Modificador de preco
-puts adamante.applicable_to   # Tipos de item aplicaveis
+puts adamante.price_modifier  # Modificador de preço
+puts adamante.applicable_to   # Tipos de item aplicáveis
 puts adamante.effects         # Efeitos
 
-# Materiais aplicaveis a armas
+# Materiais aplicáveis a armas
 Tormenta20.materiais_especiais.select do |m|
   m.applicable_to&.include?("arma")
 end

data/docs/melhorias.md

@@ -4,20 +4,20 @@ Acesso: `Tormenta20.melhorias`
 
 ## Atributos
 
-| Atributo | Tipo | Descricao |
+| Atributo | Tipo | Descrição |
 |----------|------|-----------|
-| `id` | String | Identificador unico |
+| `id` | String | Identificador único |
 | `name` | String | Nome da melhoria |
-| `description` | String | Descricao |
-| `applicable_to` | Array | Tipos de item aplicaveis |
-| `price` | String | Preco/custo |
+| `description` | String | Descrição |
+| `applicable_to` | Array | Tipos de item aplicáveis |
+| `price` | String | Preço/custo |
 | `effects` | Array | Efeitos da melhoria |
 
 ## Scopes (Filtros)
 
-Este modelo nao possui scopes especificos. Use queries ActiveRecord padrao.
+Este modelo não possui scopes específicos. Use queries ActiveRecord padrão.
 
-## Metodos de Instancia
+## Métodos de Instância
 
 ```ruby
 melhoria = Tormenta20.melhorias.first
@@ -33,12 +33,12 @@ Tormenta20.melhorias.all.each do |m|
   puts "#{m.name}: #{m.price}"
 end
 
-# Buscar melhoria especifica
+# Buscar melhoria específica
 melhoria = Tormenta20.melhorias.find("afiada")
 puts melhoria.name           # Nome
-puts melhoria.description    # Descricao
-puts melhoria.price          # Preco
-puts melhoria.applicable_to  # Tipos de item aplicaveis
+puts melhoria.description    # Descrição
+puts melhoria.price          # Preço
+puts melhoria.applicable_to  # Tipos de item aplicáveis
 
 # Melhorias para armas
 Tormenta20.melhorias.select do |m|
@@ -50,6 +50,6 @@ Tormenta20.melhorias.select do |m|
   m.applicable_to&.include?("armadura")
 end
 
-# Melhorias ordenadas por preco
+# Melhorias ordenadas por preço
 Tormenta20.melhorias.order(:price)
 ```

data/docs/poderes.md

@@ -4,22 +4,22 @@ Acesso: `Tormenta20.poderes`
 
 ## Atributos
 
-| Atributo | Tipo | Descricao |
+| Atributo | Tipo | Descrição |
 |----------|------|-----------|
-| `id` | String | Identificador unico |
+| `id` | String | Identificador único |
 | `name` | String | Nome do poder |
 | `type` | String | Tipo do poder |
-| `description` | String | Descricao |
+| `description` | String | Descrição |
 | `effects` | Array | Efeitos do poder |
-| `prerequisites` | Array | Pre-requisitos |
-| `origin_id` | String | ID da origem associada (se aplicavel) |
-| `deities` | Array | Divindades que concedem (se aplicavel) |
+| `prerequisites` | Array | Pré-requisitos |
+| `origin_id` | String | ID da origem associada (se aplicável) |
+| `deities` | Array | Divindades que concedem (se aplicável) |
 
 ## Tipos de Poder
 
-| Tipo | Descricao |
+| Tipo | Descrição |
 |------|-----------|
-| `habilidade_unica_origem` | Habilidades unicas de origem |
+| `habilidade_unica_origem` | Habilidades únicas de origem |
 | `poder_concedido` | Poderes concedidos por divindades |
 | `poder_tormenta` | Poderes da Tormenta |
 | `poder_classe` | Poderes de classe |
@@ -33,7 +33,7 @@ Acesso: `Tormenta20.poderes`
 ### Por Tipo
 
 ```ruby
-Tormenta20.poderes.habilidades_unicas   # Habilidades unicas de origem
+Tormenta20.poderes.habilidades_unicas   # Habilidades únicas de origem
 Tormenta20.poderes.poderes_concedidos   # Poderes concedidos por divindades
 Tormenta20.poderes.poderes_tormenta     # Poderes da Tormenta
 Tormenta20.poderes.poderes_classe       # Poderes de classe
@@ -53,7 +53,7 @@ Tormenta20.poderes.by_origin("soldado")  # Poderes da origem Soldado
 Tormenta20.poderes.by_deity("khalmyr")  # Poderes concedidos por Khalmyr
 ```
 
-## Metodos de Instancia
+## Métodos de Instância
 
 ```ruby
 poder = Tormenta20.poderes.find("ataque_poderoso")
@@ -79,12 +79,12 @@ Tormenta20.poderes.poderes_tormenta.each do |p|
   puts "#{p.name}: #{p.description}"
 end
 
-# Habilidades unicas de uma origem especifica
+# Habilidades únicas de uma origem específica
 Tormenta20.poderes.habilidades_unicas.by_origin("soldado").each do |p|
   puts p.name
 end
 
-# Poderes com pre-requisitos
+# Poderes com pré-requisitos
 Tormenta20.poderes.where.not(prerequisites: nil).each do |p|
   puts "#{p.name}: requer #{p.prerequisites}"
 end

data/docs/racas.md

@@ -0,0 +1,68 @@
+# Raças
+
+Acesso: `Tormenta20.racas`
+
+## Atributos
+
+| Atributo | Tipo | Descrição |
+|----------|------|-----------|
+| `id` | String | Identificador único (ex: `"anao"`) |
+| `name` | String | Nome da raça |
+| `description` | String | Descrição da raça |
+| `size` | String | Tamanho (`"minúsculo"`, `"pequeno"`, `"médio"`, `"grande"`) |
+| `movement` | Integer | Deslocamento em metros |
+| `vision` | String | Tipo de visão (`"normal"`, `"baixa_luminosidade"`, `"visao_no_escuro"`) |
+| `vision_range` | Integer / nil | Alcance da visão especial em metros |
+| `attribute_bonuses` | Hash | Bônus de atributo por nome (`{ "constituicao" => 2 }`) |
+| `skill_bonuses` | Array | Bônus em perícias |
+| `racial_abilities` | Array | Habilidades raciais fixas |
+| `chosen_abilities_amount` | Integer | Quantidade de habilidades a escolher |
+| `available_chosen_abilities` | Array | Habilidades disponíveis para escolha |
+
+## Métodos de Instância
+
+```ruby
+raca = Tormenta20.racas.find("anao")
+
+# Bônus de atributo
+raca.attribute_bonus_for("constituicao")  # => 2
+raca.attribute_bonus_for("forca")         # => 0
+
+# Tamanho
+raca.minusculo?   # => false
+raca.pequeno?     # => false
+raca.grande?      # => false
+
+# Visão
+raca.visao_no_escuro?  # => true
+
+# Conversão
+raca.to_h  # Hash completo com todos os atributos
+```
+
+## Exemplos
+
+```ruby
+# Listar todas as raças
+Tormenta20.racas.all.each do |r|
+  puts "#{r.name} (#{r.size}) - Deslocamento: #{r.movement}m"
+end
+
+# Raças com visão no escuro
+Tormenta20.racas.select(&:visao_no_escuro?).each do |r|
+  puts "#{r.name}: #{r.vision_range}m de visão no escuro"
+end
+
+# Raças com bônus em Força
+Tormenta20.racas.select { |r| r.attribute_bonus_for("forca") > 0 }
+
+# Bônus de atributos de uma raça específica
+elfo = Tormenta20.racas.find("elfo")
+elfo.attribute_bonuses  # => { "destreza" => 2, ... }
+
+# Raças pequenas
+Tormenta20.racas.select(&:pequeno?)
+
+# Referência de livro
+Tormenta20.racas.find("minotauro").book_reference  # => "T20 - EJA, p. 25"
+```