tormenta20 0.2.0 → 0.2.2

data/docs/divindades.md

@@ -0,0 +1,77 @@
+# Divindades
+
+Acesso: `Tormenta20.divindades`
+
+## Atributos
+
+| Atributo | Tipo | Descricao |
+|----------|------|-----------|
+| `id` | String | Identificador unico |
+| `name` | String | Nome da divindade |
+| `title` | String | Titulo/epiteto |
+| `description` | String | Descricao |
+| `beliefs_objectives` | String | Crencas e objetivos |
+| `holy_symbol` | String | Simbolo sagrado |
+| `energy` | String | Tipo de energia: `positiva`, `negativa`, `qualquer` |
+| `preferred_weapon` | String | Arma preferida |
+| `devotees` | Hash | Devotos tipicos (races, classes) |
+| `granted_powers` | Array | Lista de poderes concedidos |
+| `obligations_restrictions` | String | Obrigacoes e restricoes |
+
+## Scopes (Filtros)
+
+### Por Tipo de Energia
+
+```ruby
+Tormenta20.divindades.energia_positiva  # Deuses de energia positiva
+Tormenta20.divindades.energia_negativa  # Deuses de energia negativa
+Tormenta20.divindades.energia_qualquer  # Deuses de energia neutra
+Tormenta20.divindades.by_energy("positiva")
+```
+
+## Metodos de Instancia
+
+```ruby
+divindade = Tormenta20.divindades.find("khalmyr")
+
+divindade.races    # Racas devotas
+# => ["humano", "anao"]
+
+divindade.classes  # Classes devotas
+# => ["paladino", "guerreiro"]
+
+divindade.to_h     # Converte para Hash completo
+```
+
+## Exemplos
+
+```ruby
+# Listar todas as divindades
+Tormenta20.divindades.all.each do |d|
+  puts "#{d.name} - #{d.title} (#{d.energy})"
+end
+
+# Divindades de energia positiva
+Tormenta20.divindades.energia_positiva.each do |d|
+  puts "#{d.name}: #{d.granted_powers.join(', ')}"
+end
+
+# Buscar divindade especifica
+khalmyr = Tormenta20.divindades.find("khalmyr")
+puts khalmyr.name              # => "Khalmyr"
+puts khalmyr.title             # => "O Deus da Justica"
+puts khalmyr.preferred_weapon  # => "Espada longa"
+puts khalmyr.granted_powers    # Lista de poderes concedidos
+
+# Divindades que concedem um poder especifico
+Tormenta20.divindades.select do |d|
+  d.granted_powers&.include?("cura_pelas_maos")
+end
+
+# Agrupar por tipo de energia
+Tormenta20.divindades.group(:energy).count
+# => {"positiva"=>12, "negativa"=>6, "qualquer"=>2}
+
+# Divindades adoradas por uma raca
+Tormenta20.divindades.select { |d| d.races.include?("elfo") }
+```

data/docs/escudos.md

@@ -0,0 +1,49 @@
+# Escudos
+
+Acesso: `Tormenta20.escudos`
+
+## Atributos
+
+| Atributo | Tipo | Descricao |
+|----------|------|-----------|
+| `id` | String | Identificador unico |
+| `name` | String | Nome do escudo |
+| `price` | String | Preco |
+| `defense_bonus` | Integer | Bonus de defesa |
+| `armor_penalty` | Integer | Penalidade de armadura |
+| `weight` | String | Peso/espacos |
+| `properties` | Array | Propriedades especiais |
+| `description` | String | Descricao |
+
+## Scopes (Filtros)
+
+Este modelo nao possui scopes especificos. Use queries ActiveRecord padrao.
+
+## Metodos de Instancia
+
+```ruby
+escudo = Tormenta20.escudos.first
+
+escudo.to_h  # Converte para Hash completo
+```
+
+## Exemplos
+
+```ruby
+# Listar todos os escudos
+Tormenta20.escudos.all.each do |e|
+  puts "#{e.name}: +#{e.defense_bonus} Defesa, -#{e.armor_penalty} penalidade"
+end
+
+# Buscar escudo especifico
+escudo = Tormenta20.escudos.find("escudo_leve")
+puts escudo.name           # Nome
+puts escudo.defense_bonus  # Bonus de defesa
+puts escudo.armor_penalty  # Penalidade
+
+# Escudo com maior bonus
+Tormenta20.escudos.order(defense_bonus: :desc).first
+
+# Escudos ordenados por preco
+Tormenta20.escudos.order(:price)
+```

data/docs/itens.md

@@ -0,0 +1,59 @@
+# Itens
+
+Acesso: `Tormenta20.itens`
+
+## Atributos
+
+| Atributo | Tipo | Descricao |
+|----------|------|-----------|
+| `id` | String | Identificador unico |
+| `name` | String | Nome do item |
+| `category` | String | Categoria do item |
+| `price` | String | Preco |
+| `weight` | String | Peso/espacos |
+| `description` | String | Descricao |
+| `effects` | Array | Efeitos do item |
+
+## Scopes (Filtros)
+
+### Por Categoria
+
+```ruby
+Tormenta20.itens.by_category("alquimico")
+Tormenta20.itens.by_category("ferramenta")
+Tormenta20.itens.by_category("vestuario")
+```
+
+## Metodos de Instancia
+
+```ruby
+item = Tormenta20.itens.first
+
+item.to_h  # Converte para Hash completo
+```
+
+## Exemplos
+
+```ruby
+# Listar todos os itens
+Tormenta20.itens.all.each do |i|
+  puts "#{i.name}: #{i.price}"
+end
+
+# Itens de uma categoria
+Tormenta20.itens.by_category("alquimico").each do |i|
+  puts "#{i.name}: #{i.description}"
+end
+
+# Buscar item especifico
+item = Tormenta20.itens.find("corda")
+puts item.name         # Nome
+puts item.price        # Preco
+puts item.description  # Descricao
+
+# Itens ordenados por nome
+Tormenta20.itens.order(:name)
+
+# Agrupar itens por categoria
+Tormenta20.itens.group(:category).count
+```

data/docs/magias.md

@@ -0,0 +1,157 @@
+# Magias (Spells)
+
+Acesso: `Tormenta20.magias`
+
+## Atributos
+
+| Atributo | Tipo | Descricao |
+|----------|------|-----------|
+| `id` | String | Identificador unico |
+| `name` | String | Nome da magia |
+| `type` | String | Tipo: `arcana`, `divina`, `universal` |
+| `circle` | String | Circulo (1-5) |
+| `school` | String | Escola de magia |
+| `execution` | String | Tempo de execucao |
+| `execution_details` | String | Detalhes da execucao |
+| `range` | String | Alcance |
+| `duration` | String | Duracao |
+| `duration_details` | String | Detalhes da duracao |
+| `description` | String | Descricao completa |
+| `counterspell` | String | Contramagia |
+| `enhancements` | Array | Aprimoramentos disponiveis |
+| `effects` | Array | Efeitos da magia |
+
+### Atributos de Alvo
+
+| Atributo | Tipo | Descricao |
+|----------|------|-----------|
+| `target_amount` | Integer | Quantidade de alvos |
+| `target_up_to` | Boolean | Ate X alvos |
+| `target_type` | String | Tipo de alvo |
+
+### Atributos de Efeito
+
+| Atributo | Tipo | Descricao |
+|----------|------|-----------|
+| `effect` | String | Efeito principal |
+| `effect_shape` | String | Forma do efeito |
+| `effect_dimention` | String | Dimensao |
+| `effect_size` | String | Tamanho |
+| `effect_other_details` | String | Outros detalhes |
+| `area_effect` | String | Efeito de area |
+| `area_effect_details` | String | Detalhes da area |
+
+### Atributos de Resistencia
+
+| Atributo | Tipo | Descricao |
+|----------|------|-----------|
+| `resistence_effect` | String | Efeito da resistencia |
+| `resistence_skill` | String | Pericia para resistencia |
+
+### Atributos de Custo Extra
+
+| Atributo | Tipo | Descricao |
+|----------|------|-----------|
+| `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 |
+
+## Scopes (Filtros)
+
+### Por Tipo
+
+```ruby
+Tormenta20.magias.arcanas      # Magias arcanas
+Tormenta20.magias.divinas      # Magias divinas
+Tormenta20.magias.universais   # Magias universais
+Tormenta20.magias.by_type("arcana")
+```
+
+### Por Circulo
+
+```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
+```
+
+### 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("encan")   # Encantamento
+Tormenta20.magias.by_school("ilus")    # Ilusao
+Tormenta20.magias.by_school("necro")   # Necromancia
+Tormenta20.magias.by_school("trans")   # Transmutacao
+Tormenta20.magias.da_escola("evoc")    # Alias em portugues
+```
+
+### Combinando Filtros
+
+```ruby
+# Magias arcanas do 3o circulo
+Tormenta20.magias.arcanas.by_circle("3")
+
+# Magias divinas de necromancia
+Tormenta20.magias.divinas.by_school("necro")
+
+# Magias universais do 1o circulo de abjuracao
+Tormenta20.magias.universais.by_circle("1").by_school("abjur")
+```
+
+## Metodos de Classe
+
+```ruby
+Tormenta20.magias.todas           # Todas as magias (alias para .all)
+Tormenta20.magias.arcanas_list    # Lista de arcanas
+Tormenta20.magias.divinas_list    # Lista de divinas
+Tormenta20.magias.universais_list # Lista de universais
+```
+
+## Metodos de Instancia
+
+```ruby
+magia = Tormenta20.magias.find("bola_de_fogo")
+
+magia.target_info          # Hash com info do alvo
+# => { amount: 1, up_to: false, type: "criatura" }
+
+magia.effect_details_info  # Hash com detalhes do efeito
+# => { shape: "esfera", size: "6m" }
+
+magia.resistence_info      # Hash com info de resistencia
+# => { effect: "reduz", skill: "Reflexos" }
+
+magia.extra_costs_info     # Hash com custos extras
+# => { material_component: "enxofre", material_component_cost: "T$ 10" }
+
+magia.to_h                 # Converte para Hash completo
+```
+
+## Exemplos
+
+```ruby
+# Buscar magia especifica
+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"
+
+# Listar todas as magias de cura
+Tormenta20.magias.where("name LIKE ?", "%Cura%").each do |m|
+  puts "#{m.name} (#{m.type}, #{m.circle}o circulo)"
+end
+
+# Magias arcanas ordenadas por circulo
+Tormenta20.magias.arcanas.order(:circle, :name).each do |m|
+  puts "#{m.circle}o - #{m.name}"
+end
+
+# Contar magias por escola
+Tormenta20.magias.group(:school).count
+# => {"evoc"=>25, "abjur"=>15, ...}
+```

data/docs/materiais_especiais.md

@@ -0,0 +1,50 @@
+# Materiais Especiais
+
+Acesso: `Tormenta20.materiais_especiais`
+
+## Atributos
+
+| Atributo | Tipo | Descricao |
+|----------|------|-----------|
+| `id` | String | Identificador unico |
+| `name` | String | Nome do material |
+| `description` | String | Descricao |
+| `applicable_to` | Array | Tipos de item aplicaveis |
+| `price_modifier` | String | Modificador de preco |
+| `effects` | Array | Efeitos do material |
+
+## Scopes (Filtros)
+
+Este modelo nao possui scopes especificos. Use queries ActiveRecord padrao.
+
+## Metodos de Instancia
+
+```ruby
+material = Tormenta20.materiais_especiais.first
+
+material.to_h  # Converte para Hash completo
+```
+
+## Exemplos
+
+```ruby
+# Listar todos os materiais especiais
+Tormenta20.materiais_especiais.all.each do |m|
+  puts "#{m.name}: #{m.description}"
+end
+
+# Buscar material especifico
+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.effects         # Efeitos
+
+# Materiais aplicaveis a armas
+Tormenta20.materiais_especiais.select do |m|
+  m.applicable_to&.include?("arma")
+end
+
+# Materiais ordenados por nome
+Tormenta20.materiais_especiais.order(:name)
+```

data/docs/melhorias.md

@@ -0,0 +1,55 @@
+# Melhorias
+
+Acesso: `Tormenta20.melhorias`
+
+## Atributos
+
+| Atributo | Tipo | Descricao |
+|----------|------|-----------|
+| `id` | String | Identificador unico |
+| `name` | String | Nome da melhoria |
+| `description` | String | Descricao |
+| `applicable_to` | Array | Tipos de item aplicaveis |
+| `price` | String | Preco/custo |
+| `effects` | Array | Efeitos da melhoria |
+
+## Scopes (Filtros)
+
+Este modelo nao possui scopes especificos. Use queries ActiveRecord padrao.
+
+## Metodos de Instancia
+
+```ruby
+melhoria = Tormenta20.melhorias.first
+
+melhoria.to_h  # Converte para Hash completo
+```
+
+## Exemplos
+
+```ruby
+# Listar todas as melhorias
+Tormenta20.melhorias.all.each do |m|
+  puts "#{m.name}: #{m.price}"
+end
+
+# Buscar melhoria especifica
+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
+
+# Melhorias para armas
+Tormenta20.melhorias.select do |m|
+  m.applicable_to&.include?("arma")
+end
+
+# Melhorias para armaduras
+Tormenta20.melhorias.select do |m|
+  m.applicable_to&.include?("armadura")
+end
+
+# Melhorias ordenadas por preco
+Tormenta20.melhorias.order(:price)
+```

data/docs/origens.md

@@ -0,0 +1,61 @@
+# Origens
+
+Acesso: `Tormenta20.origens`
+
+## Atributos
+
+| Atributo | Tipo | Descricao |
+|----------|------|-----------|
+| `id` | String | Identificador unico |
+| `name` | String | Nome da origem |
+| `description` | String | Descricao da origem |
+| `items` | Array | Itens iniciais |
+| `benefits` | Hash | Beneficios (skills, powers) |
+| `unique_power` | Hash | Poder unico da origem |
+
+## Scopes (Filtros)
+
+```ruby
+# Origens que possuem poder unico
+Tormenta20.origens.with_unique_power
+```
+
+## Metodos de Instancia
+
+```ruby
+origem = Tormenta20.origens.find("soldado")
+
+origem.skills   # Pericias treinadas pela origem
+# => ["Fortitude", "Luta"]
+
+origem.powers   # Poderes concedidos pela origem
+# => ["Proficiencia"]
+
+origem.to_h     # Converte para Hash completo
+```
+
+## Exemplos
+
+```ruby
+# Listar todas as origens
+Tormenta20.origens.all.each do |o|
+  puts "#{o.name}: #{o.skills.join(', ')}"
+end
+
+# Origens com poder unico
+Tormenta20.origens.with_unique_power.each do |o|
+  puts "#{o.name}: #{o.unique_power['name']}"
+end
+
+# Buscar origem especifica
+soldado = Tormenta20.origens.find("soldado")
+puts soldado.name         # => "Soldado"
+puts soldado.description  # Descricao completa
+puts soldado.items        # Itens iniciais
+
+# Origens que concedem uma pericia especifica
+Tormenta20.origens.select { |o| o.skills.include?("Furtividade") }
+
+# Contar origens com poder unico
+Tormenta20.origens.with_unique_power.count
+```

data/docs/poderes.md

@@ -0,0 +1,98 @@
+# Poderes
+
+Acesso: `Tormenta20.poderes`
+
+## Atributos
+
+| Atributo | Tipo | Descricao |
+|----------|------|-----------|
+| `id` | String | Identificador unico |
+| `name` | String | Nome do poder |
+| `type` | String | Tipo do poder |
+| `description` | String | Descricao |
+| `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) |
+
+## Tipos de Poder
+
+| Tipo | Descricao |
+|------|-----------|
+| `habilidade_unica_origem` | Habilidades unicas de origem |
+| `poder_concedido` | Poderes concedidos por divindades |
+| `poder_tormenta` | Poderes da Tormenta |
+| `poder_classe` | Poderes de classe |
+| `poder_geral` | Poderes gerais |
+| `poder_combate` | Poderes de combate |
+| `poder_destino` | Poderes de destino |
+| `poder_magia` | Poderes de magia |
+
+## Scopes (Filtros)
+
+### Por Tipo
+
+```ruby
+Tormenta20.poderes.habilidades_unicas   # Habilidades unicas de origem
+Tormenta20.poderes.poderes_concedidos   # Poderes concedidos por divindades
+Tormenta20.poderes.poderes_tormenta     # Poderes da Tormenta
+Tormenta20.poderes.poderes_classe       # Poderes de classe
+Tormenta20.poderes.poderes_gerais       # Poderes gerais
+Tormenta20.poderes.by_type("poder_combate")
+```
+
+### Por Origem
+
+```ruby
+Tormenta20.poderes.by_origin("soldado")  # Poderes da origem Soldado
+```
+
+### Por Divindade
+
+```ruby
+Tormenta20.poderes.by_deity("khalmyr")  # Poderes concedidos por Khalmyr
+```
+
+## Metodos de Instancia
+
+```ruby
+poder = Tormenta20.poderes.find("ataque_poderoso")
+
+poder.to_h  # Converte para Hash completo
+```
+
+## Exemplos
+
+```ruby
+# Listar todos os poderes
+Tormenta20.poderes.all.each do |p|
+  puts "#{p.name} (#{p.type})"
+end
+
+# Poderes concedidos por divindades
+Tormenta20.poderes.poderes_concedidos.each do |p|
+  puts "#{p.name}: #{p.deities&.join(', ')}"
+end
+
+# Poderes da Tormenta
+Tormenta20.poderes.poderes_tormenta.each do |p|
+  puts "#{p.name}: #{p.description}"
+end
+
+# Habilidades unicas de uma origem especifica
+Tormenta20.poderes.habilidades_unicas.by_origin("soldado").each do |p|
+  puts p.name
+end
+
+# Poderes com pre-requisitos
+Tormenta20.poderes.where.not(prerequisites: nil).each do |p|
+  puts "#{p.name}: requer #{p.prerequisites}"
+end
+
+# Contar poderes por tipo
+Tormenta20.poderes.group(:type).count
+# => {"poder_concedido"=>50, "habilidade_unica_origem"=>35, ...}
+
+# Buscar poderes por nome
+Tormenta20.poderes.where("name LIKE ?", "%Furia%")
+```

data/docs/regras.md

@@ -0,0 +1,51 @@
+# Regras
+
+Acesso: `Tormenta20.regras`
+
+## Atributos
+
+| Atributo | Tipo | Descricao |
+|----------|------|-----------|
+| `id` | String | Identificador unico |
+| `name` | String | Nome da regra/tabela |
+| `description` | String | Descricao |
+| `data` | Hash | Dados estruturados da regra |
+
+## Scopes (Filtros)
+
+Este modelo nao possui scopes especificos. Use queries ActiveRecord padrao.
+
+## Metodos de Instancia
+
+```ruby
+regra = Tormenta20.regras.first
+
+regra.to_h  # Converte para Hash completo
+```
+
+## Exemplos
+
+```ruby
+# Listar todas as regras
+Tormenta20.regras.all.each do |r|
+  puts "#{r.name}: #{r.description}"
+end
+
+# Buscar regra especifica
+pericias = Tormenta20.regras.find("pericias")
+puts pericias.name         # => "Pericias"
+puts pericias.description  # Descricao
+puts pericias.data         # Dados estruturados (Hash)
+
+# Acessar dados de uma regra
+condicoes = Tormenta20.regras.find("condicoes")
+condicoes.data.each do |key, value|
+  puts "#{key}: #{value}"
+end
+
+# Buscar regras por nome
+Tormenta20.regras.where("name LIKE ?", "%combate%")
+
+# Regras ordenadas por nome
+Tormenta20.regras.order(:name)
+```