tormenta20 0.2.11 → 0.2.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 61061e8d442fe601acf2fab0aa5abbde0bb581c3cd392a823a5f098fbe389042
-  data.tar.gz: c48702b21f4c252cd259a5d16b8412655a9118c77d37eb6fef4a6103e094051d
+  metadata.gz: 1f886f621c00e35038fde523eacced3f4175b13e8bab3bd074bfab3f9637dffb
+  data.tar.gz: e9e38bcbda3848467cc947012f8e199fd837041e600f96c5731541d3ad28d3a6
 SHA512:
-  metadata.gz: 7555285167b243450af2fca516b0453a763ebecccf5937f9336817212c33f638a0392feb9ac1adebb679b7f737d05e0b80f62b88c9c71593edeae49b05d1e011
-  data.tar.gz: b74fb54b7ae483dc574a6cab2845da668d9ddc2c5aed345dcb5379ce1069999c2c289a91f390c1cfdbf5c4da63317bb92d480aca6126266cec1a4fac4eed89d2
+  metadata.gz: af7f1457d16363868626614eab6cb5e029d84d961e602daf4328f8e10eaaec00c4cab3a5c3a5310274355bb9f4fcd0f6c442def10c651055145f33594f951113
+  data.tar.gz: dd0aad7e3d8f04ff788621acdcac1101da78ee064f70770a7da8b5b6226b2e760b07f589246852f2975b4cc9833f682653dc943e0afe853a43b9a81cb70165c1

data/README.md

@@ -2,11 +2,29 @@
 
 Uma biblioteca Ruby com dados do RPG de mesa brasileiro Tormenta20.
 
-A gem inclui um banco de dados SQLite pré-populado com informações sobre magias, classes, origens, divindades, poderes e equipamentos do sistema Tormenta20.
+A gem inclui um banco de dados SQLite pré-populado com informações sobre magias, classes, origens, divindades, poderes, equipamentos, raças e condições do sistema Tormenta20. Todos os registros expõem referências de livro e página via o concern `BookReferenceable`.
+
+## Dependências do Sistema
+
+A gem usa SQLite3 para armazenar os dados. O driver Ruby (`sqlite3` gem) vem com binaries pré-compilados, mas em ambientes Linux (incluindo Docker) a biblioteca de runtime precisa estar presente:
+
+```bash
+# Debian/Ubuntu
+apt-get install libsqlite3-0
+
+# Alpine
+apk add sqlite-libs
+```
+
+No Dockerfile da sua aplicação:
+
+```dockerfile
+RUN apt-get install --no-install-recommends -y libsqlite3-0
+```
 
 ## Installation
 
-Adicione ao Gemfile da sua aplicacao:
+Adicione ao Gemfile da sua aplicação:
 
 ```ruby
 gem 'tormenta20'
@@ -26,7 +44,7 @@ gem install tormenta20
 
 ## Usage
 
-A gem ja vem com o banco de dados populado. Basta fazer require e usar:
+A gem já vem com o banco de dados populado. Basta fazer require e usar:
 
 ```ruby
 require 'tormenta20'
@@ -35,18 +53,22 @@ require 'tormenta20'
 Tormenta20.magias.count                    # => 198
 Tormenta20.magias.arcanas                  # Magias arcanas
 Tormenta20.magias.divinas                  # Magias divinas
-Tormenta20.magias.by_circle("3")           # Magias do 3o circulo
-Tormenta20.magias.by_school('evoc')        # Magias de evocacao
+Tormenta20.magias.by_circle("3")           # Magias do 3º círculo
+Tormenta20.magias.by_school('evoc')        # Magias de evocação
 Tormenta20.magias.arcanas.by_circle("1")   # Combinar filtros
 
 # Classes
 Tormenta20.classes.all
 Tormenta20.classes.conjuradores            # Classes com magia
 
+# Raças
+Tormenta20.racas.all
+Tormenta20.racas.find('anao')
+
 # Origens
 Tormenta20.origens.all
 Tormenta20.origens.find('soldado')
-Tormenta20.origens.with_unique_power       # Origens com poder unico
+Tormenta20.origens.with_unique_power       # Origens com poder único
 
 # Divindades
 Tormenta20.divindades.all
@@ -55,10 +77,16 @@ Tormenta20.divindades.energia_negativa     # Deuses de energia negativa
 
 # Poderes
 Tormenta20.poderes.all
-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
 
+# Condições
+Tormenta20.condicoes.all
+Tormenta20.condicoes.by_type('medo')
+Tormenta20.condicoes.medo
+Tormenta20.condicoes.mental
+
 # Equipamentos
 Tormenta20.armas.all
 Tormenta20.armas.simples                   # Armas simples
@@ -69,17 +97,24 @@ Tormenta20.escudos.all
 
 # Itens Superiores
 Tormenta20.materiais_especiais.all
+Tormenta20.melhorias.all
 
 # Regras
 Tormenta20.regras.all
+
+# Índice Remissivo
+Tormenta20.livros.all
+Tormenta20.indice_remissivo.do_livro('t20_eja')
+Tormenta20.indice_remissivo.para_tabela('classes')
+Tormenta20.indice_remissivo.buscar_termo('Fúria')
 ```
 
 ### Query Interface
 
-A gem oferece uma interface de consulta simplificada. Todos os metodos retornam modelos ActiveRecord, permitindo encadeamento de scopes e queries:
+A gem oferece uma interface de consulta simplificada. Todos os métodos retornam modelos ActiveRecord, permitindo encadeamento de scopes e queries:
 
 ```ruby
-# Accessors disponiveis
+# Accessors disponíveis
 Tormenta20.origens              # => Tormenta20::Models::Origem
 Tormenta20.poderes              # => Tormenta20::Models::Poder
 Tormenta20.divindades           # => Tormenta20::Models::Divindade
@@ -92,67 +127,128 @@ Tormenta20.itens                # => Tormenta20::Models::Item
 Tormenta20.materiais_especiais  # => Tormenta20::Models::MaterialEspecial
 Tormenta20.melhorias            # => Tormenta20::Models::Melhoria
 Tormenta20.regras               # => Tormenta20::Models::Regra
+Tormenta20.racas                # => Tormenta20::Models::Raca
+Tormenta20.condicoes            # => Tormenta20::Models::Condicao
+Tormenta20.livros               # => Tormenta20::Models::Livro
+Tormenta20.indice_remissivo     # => Tormenta20::Models::IndiceRemissivo
 
 # Exemplos de queries ActiveRecord
 Tormenta20.magias.where(type: 'arcana')
 Tormenta20.magias.where(school: 'evoc').order(:name)
-Tormenta20.poderes.where("name LIKE ?", "%Furia%")
+Tormenta20.poderes.where("name LIKE ?", "%Fúria%")
 ```
 
-### Models Disponiveis
+### Models Disponíveis
 
-| Model | Descricao | Quantidade | Documentacao |
+| Model | Descrição | Quantidade | Documentação |
 |-------|-----------|------------|--------------|
 | `Magia` | Magias arcanas, divinas e universais | 198 | [docs/magias.md](docs/magias.md) |
 | `Classe` | Classes de personagem | 14 | [docs/classes.md](docs/classes.md) |
 | `Origem` | Origens de personagem | 35 | [docs/origens.md](docs/origens.md) |
-| `Divindade` | Deuses do Panteao | 20 | [docs/divindades.md](docs/divindades.md) |
-| `Poder` | Poderes (habilidades unicas, concedidos, tormenta) | 129 | [docs/poderes.md](docs/poderes.md) |
+| `Divindade` | Deuses do Panteão | 20 | [docs/divindades.md](docs/divindades.md) |
+| `Poder` | Poderes (habilidades únicas, concedidos, tormenta, classe, raça) | 518 | [docs/poderes.md](docs/poderes.md) |
+| `Raca` | Raças jogáveis | 18 | [docs/racas.md](docs/racas.md) |
+| `Condicao` | Condições de status | 35 | [docs/condicoes.md](docs/condicoes.md) |
 | `Arma` | Armas | - | [docs/armas.md](docs/armas.md) |
 | `Armadura` | Armaduras | - | [docs/armaduras.md](docs/armaduras.md) |
 | `Escudo` | Escudos | 2 | [docs/escudos.md](docs/escudos.md) |
 | `Item` | Itens gerais | - | [docs/itens.md](docs/itens.md) |
 | `MaterialEspecial` | Materiais especiais | 6 | [docs/materiais_especiais.md](docs/materiais_especiais.md) |
-| `Melhoria` | Melhorias magicas | - | [docs/melhorias.md](docs/melhorias.md) |
-| `Regra` | Regras e dados de referencia | 14 | [docs/regras.md](docs/regras.md) |
+| `Melhoria` | Melhorias mágicas | - | [docs/melhorias.md](docs/melhorias.md) |
+| `Regra` | Regras e dados de referência | 14 | [docs/regras.md](docs/regras.md) |
+| `Livro` | Livros indexados | 1 | [docs/livros.md](docs/livros.md) |
+| `IndiceRemissivo` | Entradas do índice remissivo | 1098 | [docs/indice_remissivo.md](docs/indice_remissivo.md) |
+
+### Referência de Livro e Página
+
+Todos os modelos incluem o concern `BookReferenceable`. Se o registro estiver indexado no índice remissivo, os seguintes métodos ficam disponíveis:
 
-> Cada link de documentacao contem a lista completa de atributos, scopes, metodos e exemplos de uso.
+```ruby
+guerreiro = Tormenta20.classes.find('guerreiro')
+
+guerreiro.book_reference  # => "T20 - EJA, p. 64"
+guerreiro.page            # => 64
+guerreiro.book            # => "T20 - EJA"
+guerreiro.full_book       # => "Tormenta 20 - Edição Jogo do Ano"
+
+# Retorna nil se o registro não estiver no índice
+item_sem_indice = Tormenta20.itens.first
+item_sem_indice.book_reference  # => nil
+```
+
+O resultado é memoizado por instância — o banco é consultado apenas uma vez por objeto.
+
+Os dados do índice remissivo são carregados de `src/json/indice_remissivo/<livro_id>.json`. Atualmente inclui o índice de **Tormenta 20 - Edição Jogo do Ano** (`t20_eja`) com mais de 1000 entradas.
+
+### Índice Remissivo
+
+O model `IndiceRemissivo` permite buscar entradas por livro, tabela ou termo:
+
+```ruby
+# Todas as entradas de um livro
+Tormenta20.indice_remissivo.do_livro('t20_eja')
+
+# Entradas vinculadas a uma tabela específica
+Tormenta20.indice_remissivo.para_tabela('classes')
+
+# Entradas vinculadas a registros concretos
+Tormenta20.indice_remissivo.associados
+
+# Entradas sem vínculo a registro
+Tormenta20.indice_remissivo.nao_associados
+
+# Busca por termo
+Tormenta20.indice_remissivo.buscar_termo('Fúria')
+
+# Consultar o livro de uma entrada
+entrada = Tormenta20.indice_remissivo.first
+entrada.livro.nome        # => "Tormenta 20 - Edição Jogo do Ano"
+entrada.livro.nome_curto  # => "T20 - EJA"
+```
 
 ### Exemplos
 
 ```ruby
-# Buscar uma magia especifica
+# Buscar uma 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"
-puts bola_de_fogo.school      # => "evoc"
-puts bola_de_fogo.description
+puts bola_de_fogo.name            # => "Bola de Fogo"
+puts bola_de_fogo.circle          # => "3"
+puts bola_de_fogo.school          # => "evoc"
+puts bola_de_fogo.book_reference  # => "T20 - EJA, p. ..."
 
 # Listar poderes de uma divindade
 khalmyr = Tormenta20.divindades.find('khalmyr')
 puts khalmyr.name             # => "Khalmyr"
 puts khalmyr.granted_powers   # => ["coragem_total", "espada_justiceira", ...]
+puts khalmyr.book_reference   # => "T20 - EJA, p. 99"
 
-# Buscar poderes concedidos
-Tormenta20.poderes.poderes_concedidos.each do |poder|
-  puts "#{poder.name}: #{poder.deities.join(', ')}"
-end
-
-# Classe com informacoes de magia
+# Classe com informações de magia e referência de livro
 mago = Tormenta20.classes.find('arcanista')
 puts mago.initial_hp          # PV inicial
-puts mago.mp_per_level        # PM por nivel
+puts mago.mp_per_level        # PM por nível
 puts mago.conjurador?         # => true
+puts mago.book_reference      # => "T20 - EJA, p. 36"
+
+# Raça com bônus de atributo
+anao = Tormenta20.racas.find('anao')
+puts anao.attribute_bonus_for('constituicao')  # => 2
+puts anao.visao_no_escuro?                     # => true
+puts anao.book_reference                       # => "T20 - EJA, p. 20"
 
-# Filtrar magias arcanas do 1o circulo da escola de evocacao
+# Filtrar magias arcanas do 1º círculo da escola de evocação
 Tormenta20.magias.arcanas.by_circle("1").by_school("evoc").each do |magia|
-  puts "#{magia.name} - #{magia.description}"
+  puts "#{magia.name} - #{magia.book_reference}"
+end
+
+# Condições de medo
+Tormenta20.condicoes.medo.each do |c|
+  puts "#{c.name}: #{c.escalates_to ? "escala para #{c.escalates_to}" : 'não escala'}"
 end
 ```
 
 ## Development
 
-### Pre-requisitos
+### Pré-requisitos
 
 - Ruby >= 3.0.0
 - Bundler
@@ -167,7 +263,7 @@ bundle install
 
 ### Construir o Banco de Dados
 
-O banco de dados SQLite e construido a partir dos arquivos JSON em `src/json/`:
+O banco de dados SQLite é construído a partir dos arquivos JSON em `src/json/`:
 
 ```bash
 # Construir apenas o banco
@@ -193,16 +289,21 @@ tormenta20/
 │   │   │   └── poderes_da_tormenta/
 │   │   ├── equipamentos/
 │   │   ├── itens_superiores/
-│   │   └── regras/
-│   └── ruby/                    # Codigo Ruby
+│   │   ├── regras/
+│   │   ├── condicoes/
+│   │   ├── racas/
+│   │   ├── livros/
+│   │   └── indice_remissivo/    # Índice por livro (ex: t20_eja.json)
+│   └── ruby/                    # Código Ruby
 │       └── tormenta20/
 │           ├── models/          # ActiveRecord models
-│           ├── database.rb      # Conexao com banco
+│           ├── concerns/        # Mixins (BookReferenceable)
+│           ├── database.rb      # Conexão com banco
 │           └── seeder.rb        # Import de dados
 ├── db/
 │   ├── schema.sql              # Schema SQLite
 │   ├── seeds.rb                # Script de seed (desenvolvimento)
-│   └── tormenta20.sqlite3      # Banco pre-construido (gerado)
+│   └── tormenta20.sqlite3      # Banco pré-construído (gerado)
 └── bin/
     └── build_db                # Script de build do banco
 ```
@@ -221,12 +322,12 @@ rake rubocop
 
 ## Contributing
 
-Bug reports e pull requests sao bem-vindos em https://github.com/LuanGB/tormenta20.
+Bug reports e pull requests são bem-vindos em https://github.com/LuanGB/tormenta20.
 
 ## License
 
-Disponivel como open source sob os termos da [MIT License](https://opensource.org/licenses/MIT).
+Disponível como open source sob os termos da [MIT License](https://opensource.org/licenses/MIT).
 
 ## Aviso Legal
 
-Tormenta20 e uma marca registrada da Jambo Editora. Esta biblioteca e um projeto de fa nao oficial e nao e afiliada, endossada ou patrocinada pela Jambo Editora.
+Tormenta20 é uma marca registrada da Jambô Editora. Esta biblioteca é um projeto de fã não oficial e não é afiliada, endossada ou patrocinada pela Jambô Editora.

data/db/schema.sql

@@ -399,6 +399,50 @@ BEGIN
   UPDATE condicoes SET updated_at = CURRENT_TIMESTAMP WHERE id = NEW.id;
 END;
 
+-- -----------------------------------------------------------------------------
+-- LIVROS (Books) — fonte bibliográfica dos dados
+-- -----------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS livros (
+  id        TEXT PRIMARY KEY,   -- slug do livro, ex: "t20_eja"
+  nome      TEXT NOT NULL,      -- nome completo
+  nome_curto TEXT NOT NULL,     -- abreviação exibida, ex: "T20 - EJA"
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE TRIGGER IF NOT EXISTS update_livros_timestamp
+AFTER UPDATE ON livros
+BEGIN
+  UPDATE livros SET updated_at = CURRENT_TIMESTAMP WHERE id = NEW.id;
+END;
+
+-- -----------------------------------------------------------------------------
+-- INDICE_REMISSIVO — entradas do índice remissivo dos livros
+-- Cada linha é um termo do índice associado a uma página.
+-- Os campos `tabela` e `registro_id` são preenchidos quando o termo é
+-- associado a um registro de outra tabela (ex: classes, poderes, magias…).
+-- -----------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS indice_remissivo (
+  id          INTEGER PRIMARY KEY AUTOINCREMENT,
+  livro_id    TEXT    NOT NULL REFERENCES livros(id),
+  termo       TEXT    NOT NULL,  -- termo exatamente como aparece no índice
+  pagina      INTEGER NOT NULL,  -- número da página
+  tabela      TEXT,              -- tabela associada (ex: "classes", "poderes")
+  registro_id TEXT,              -- id do registro associado (ex: "guerreiro")
+  created_at  DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at  DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_indice_termo    ON indice_remissivo(termo);
+CREATE INDEX IF NOT EXISTS idx_indice_livro    ON indice_remissivo(livro_id);
+CREATE INDEX IF NOT EXISTS idx_indice_registro ON indice_remissivo(tabela, registro_id);
+
+CREATE TRIGGER IF NOT EXISTS update_indice_remissivo_timestamp
+AFTER UPDATE ON indice_remissivo
+BEGIN
+  UPDATE indice_remissivo SET updated_at = CURRENT_TIMESTAMP WHERE id = NEW.id;
+END;
+
 -- =============================================================================
 -- VIEWS ÚTEIS
 -- =============================================================================

data/docs/armaduras.md

@@ -4,17 +4,17 @@ Acesso: `Tormenta20.armaduras`
 
 ## Atributos
 
-| Atributo | Tipo | Descricao |
+| Atributo | Tipo | Descrição |
 |----------|------|-----------|
-| `id` | String | Identificador unico |
+| `id` | String | Identificador único |
 | `name` | String | Nome da armadura |
 | `category` | String | Categoria: `leve`, `pesada` |
-| `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)
 
@@ -26,15 +26,15 @@ Tormenta20.armaduras.pesadas  # Armaduras pesadas
 Tormenta20.armaduras.by_category("leve")
 ```
 
-## Metodos de Instancia
+## Métodos de Instância
 
 ```ruby
 armadura = Tormenta20.armaduras.find("couro")
 
-armadura.leve?    # Verifica se e armadura leve
+armadura.leve?    # Verifica se é armadura leve
 # => true
 
-armadura.pesada?  # Verifica se e armadura pesada
+armadura.pesada?  # Verifica se é armadura pesada
 # => false
 
 armadura.to_h     # Converte para Hash completo
@@ -53,18 +53,18 @@ Tormenta20.armaduras.leves.each do |a|
   puts "#{a.name} - #{a.price}"
 end
 
-# Armaduras pesadas ordenadas por bonus de defesa
+# Armaduras pesadas ordenadas por bônus de defesa
 Tormenta20.armaduras.pesadas.order(defense_bonus: :desc).each do |a|
   puts "#{a.name}: +#{a.defense_bonus}"
 end
 
-# Buscar armadura especifica
+# Buscar armadura específica
 brunea = Tormenta20.armaduras.find("brunea")
 puts brunea.name           # => "Brunea"
-puts brunea.defense_bonus  # Bonus de defesa
+puts brunea.defense_bonus  # Bônus de defesa
 puts brunea.armor_penalty  # Penalidade
 
-# Armadura com maior bonus de defesa
+# Armadura com maior bônus de defesa
 Tormenta20.armaduras.order(defense_bonus: :desc).first
 
 # Armaduras sem penalidade

data/docs/armas.md

@@ -4,19 +4,19 @@ Acesso: `Tormenta20.armas`
 
 ## Atributos
 
-| Atributo | Tipo | Descricao |
+| Atributo | Tipo | Descrição |
 |----------|------|-----------|
-| `id` | String | Identificador unico |
+| `id` | String | Identificador único |
 | `name` | String | Nome da arma |
 | `category` | String | Categoria: `simples`, `marciais`, `exoticas`, `fogo` |
-| `price` | String | Preco |
+| `price` | String | Preço |
 | `damage` | String | Dano (ex: "1d8") |
-| `damage_type` | String | Tipo de dano (corte, perfuracao, etc) |
-| `critical` | String | Critico (ex: "19/x2") |
-| `range` | String | Alcance (para armas de distancia) |
-| `weight` | String | Peso/espacos |
+| `damage_type` | String | Tipo de dano (corte, perfuração, etc) |
+| `critical` | String | Crítico (ex: "19/x2") |
+| `range` | String | Alcance (para armas de distância) |
+| `weight` | String | Peso/espaços |
 | `properties` | Array | Propriedades especiais |
-| `description` | String | Descricao |
+| `description` | String | Descrição |
 
 ## Scopes (Filtros)
 
@@ -25,7 +25,7 @@ Acesso: `Tormenta20.armas`
 ```ruby
 Tormenta20.armas.simples    # Armas simples
 Tormenta20.armas.marciais   # Armas marciais
-Tormenta20.armas.exoticas   # Armas exoticas
+Tormenta20.armas.exoticas   # Armas exóticas
 Tormenta20.armas.fogo       # Armas de fogo
 Tormenta20.armas.by_category("simples")
 ```
@@ -41,16 +41,16 @@ Tormenta20.armas.by_damage_type("impacto")
 ### Por Alcance
 
 ```ruby
-Tormenta20.armas.ranged  # Armas de distancia (com alcance)
+Tormenta20.armas.ranged  # Armas de distância (com alcance)
 Tormenta20.armas.melee   # Armas corpo a corpo (sem alcance)
 ```
 
-## Metodos de Instancia
+## Métodos de Instância
 
 ```ruby
 arma = Tormenta20.armas.find("espada_longa")
 
-arma.ranged?  # Verifica se e arma de distancia
+arma.ranged?  # Verifica se é arma de distância
 # => false
 
 arma.to_h     # Converte para Hash completo
@@ -69,7 +69,7 @@ Tormenta20.armas.simples.each do |a|
   puts "#{a.name} - #{a.price}"
 end
 
-# Armas de distancia
+# Armas de distância
 Tormenta20.armas.ranged.each do |a|
   puts "#{a.name}: alcance #{a.range}"
 end
@@ -79,7 +79,7 @@ Tormenta20.armas.by_damage_type("corte").each do |a|
   puts "#{a.name}: #{a.damage}"
 end
 
-# Buscar arma especifica
+# Buscar arma específica
 espada = Tormenta20.armas.find("espada_longa")
 puts espada.name        # => "Espada Longa"
 puts espada.damage      # => "1d8"

data/docs/condicoes.md

@@ -0,0 +1,77 @@
+# Condições
+
+Acesso: `Tormenta20.condicoes`
+
+## Atributos
+
+| Atributo | Tipo | Descrição |
+|----------|------|-----------|
+| `id` | String | Identificador único (ex: `"abalado"`) |
+| `name` | String | Nome da condição |
+| `description` | String | Descrição completa da condição |
+| `effects` | Array | Lista de efeitos mecânicos |
+| `condition_type` | String / nil | Categoria da condição (ver abaixo) |
+| `escalates_to` | String / nil | ID da condição para a qual esta escala ao ser reaplicada |
+
+### Tipos de Condição (`condition_type`)
+
+| Tipo | Descrição |
+|------|-----------|
+| `medo` | Condições de medo (abalado, apavorado) |
+| `mental` | Condições mentais (fascinado, confuso) |
+| `metabolismo` | Condições metabólicas (envenenado, doente) |
+| `movimento` | Condições de movimento (lento, imóvel, paralisado) |
+| `veneno` | Condições de veneno |
+| `sentidos` | Condições de sentido (cego, surdo) |
+| `cansaco` | Condições de fadiga (fatigado, exausto) |
+| `metamorfose` | Condições de metamorfose (petrificado) |
+
+## Scopes (Filtros)
+
+```ruby
+Tormenta20.condicoes.by_type("medo")    # Filtro genérico por tipo
+Tormenta20.condicoes.medo               # Condições de medo
+Tormenta20.condicoes.mental             # Condições mentais
+Tormenta20.condicoes.metabolismo        # Condições metabólicas
+Tormenta20.condicoes.movimento          # Condições de movimento
+```
+
+## Métodos de Instância
+
+```ruby
+condicao = Tormenta20.condicoes.find("abalado")
+
+condicao.name           # => "Abalado"
+condicao.description    # Texto completo
+condicao.effects        # => ["...", "..."]
+condicao.condition_type # => "medo"
+condicao.escalates_to   # => "apavorado" (ou nil)
+
+condicao.to_h           # Hash completo
+```
+
+## Exemplos
+
+```ruby
+# Listar todas as condições
+Tormenta20.condicoes.all.each do |c|
+  puts c.name
+end
+
+# Condições que escalam para outra
+Tormenta20.condicoes.select { |c| c.escalates_to.present? }.each do |c|
+  puts "#{c.name} → #{c.escalates_to}"
+end
+
+# Condições de medo em ordem de gravidade
+Tormenta20.condicoes.medo.each do |c|
+  puts "#{c.name}: #{c.effects.first}"
+end
+
+# Efeitos de uma condição específica
+paralisado = Tormenta20.condicoes.find("paralisado")
+paralisado.effects.each { |e| puts "- #{e}" }
+
+# Referência de livro
+Tormenta20.condicoes.find("abalado").book_reference  # => "T20 - EJA, p. 394"
+```

data/docs/divindades.md

@@ -4,19 +4,19 @@ Acesso: `Tormenta20.divindades`
 
 ## Atributos
 
-| Atributo | Tipo | Descricao |
+| Atributo | Tipo | Descrição |
 |----------|------|-----------|
-| `id` | String | Identificador unico |
+| `id` | String | Identificador único |
 | `name` | String | Nome da divindade |
-| `title` | String | Titulo/epiteto |
-| `description` | String | Descricao |
-| `beliefs_objectives` | String | Crencas e objetivos |
-| `holy_symbol` | String | Simbolo sagrado |
+| `title` | String | Título/epíteto |
+| `description` | String | Descrição |
+| `beliefs_objectives` | String | Crenças e objetivos |
+| `holy_symbol` | String | Símbolo sagrado |
 | `energy` | String | Tipo de energia: `positiva`, `negativa`, `qualquer` |
 | `preferred_weapon` | String | Arma preferida |
-| `devotees` | Hash | Devotos tipicos (races, classes) |
+| `devotees` | Hash | Devotos típicos (races, classes) |
 | `granted_powers` | Array | Lista de poderes concedidos |
-| `obligations_restrictions` | String | Obrigacoes e restricoes |
+| `obligations_restrictions` | String | Obrigações e restrições |
 
 ## Scopes (Filtros)
 
@@ -29,12 +29,12 @@ Tormenta20.divindades.energia_qualquer  # Deuses de energia neutra
 Tormenta20.divindades.by_energy("positiva")
 ```
 
-## Metodos de Instancia
+## Métodos de Instância
 
 ```ruby
 divindade = Tormenta20.divindades.find("khalmyr")
 
-divindade.races    # Racas devotas
+divindade.races    # Raças devotas
 # => ["humano", "anao"]
 
 divindade.classes  # Classes devotas
@@ -56,14 +56,14 @@ Tormenta20.divindades.energia_positiva.each do |d|
   puts "#{d.name}: #{d.granted_powers.join(', ')}"
 end
 
-# Buscar divindade especifica
+# Buscar divindade específica
 khalmyr = Tormenta20.divindades.find("khalmyr")
 puts khalmyr.name              # => "Khalmyr"
-puts khalmyr.title             # => "O Deus da Justica"
+puts khalmyr.title             # => "O Deus da Justiça"
 puts khalmyr.preferred_weapon  # => "Espada longa"
 puts khalmyr.granted_powers    # Lista de poderes concedidos
 
-# Divindades que concedem um poder especifico
+# Divindades que concedem um poder específico
 Tormenta20.divindades.select do |d|
   d.granted_powers&.include?("cura_pelas_maos")
 end
@@ -72,6 +72,6 @@ end
 Tormenta20.divindades.group(:energy).count
 # => {"positiva"=>12, "negativa"=>6, "qualquer"=>2}
 
-# Divindades adoradas por uma raca
+# Divindades adoradas por uma raça
 Tormenta20.divindades.select { |d| d.races.include?("elfo") }
 ```