tormenta20 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b317a7a72c153c5459514af0d8da880d96262acb3197fe5767db476a21a7934e
-  data.tar.gz: 53430745f78997003a93f7047aa3b0eee3416e846e8331dd44017f1dc7c37784
+  metadata.gz: 775c13dccef6b13bcd76ea3efc8e2cf8b4c5221faf4fb73dffce3ce9b265a101
+  data.tar.gz: 88618dbc1c4c5d1e6c6e9127e39b1c2726423bf79b0c8229452dc5c767273d0f
 SHA512:
-  metadata.gz: 523855e9fca1f09ddbf0e82187cf2aa14032ddb74e8d43de49660c4b9cd19560fa6efcc1591ad4af796b0aaf7227dd2966fba852ba95bb8656079cc757d8e397
-  data.tar.gz: 31b034fd1c721ade7c1bc8e5ed24437b14fbd92e6888bc352e8b56dd1737fc44b8c4948094cfa1a37490036e25572b5f07d8368877b150981742fe3ce7afb4af
+  metadata.gz: 759238af753ee81ef3619f372a7938c6a8a656988d63dca357bf997fdbe2dea6df45a2a1dbda5fc5374a4e49f52cb07c71f30d1ce33435e86a88332da4aa8f39
+  data.tar.gz: d3ead8b84ef084bdd77c6399d1b92fcafb8773cacd0b6a965bab9437356657246121ff880af605172baf6f2e129956a235ea8fc9566b6b21e37bcd01557ce91e

data/.rubocop.yml

@@ -6,3 +6,30 @@ Style/StringLiterals:
 
 Style/StringLiteralsInInterpolation:
   EnforcedStyle: double_quotes
+
+Metrics/AbcSize:
+  Enabled: false
+
+Metrics/BlockLength:
+  Enabled: false
+
+Metrics/ClassLength:
+  Enabled: false
+
+Metrics/CyclomaticComplexity:
+  Enabled: false
+
+Metrics/MethodLength:
+  Enabled: false
+
+Metrics/ModuleLength:
+  Enabled: false
+
+Metrics/ParameterLists:
+  Enabled: false
+
+Metrics/PerceivedComplexity:
+  Enabled: false
+
+Layout/LineLength:
+  Max: 200

data/README.md

@@ -1,18 +1,24 @@
 # Tormenta20
 
-TODO: Delete this and the text below, and describe your gem
+Uma biblioteca Ruby com dados do RPG de mesa brasileiro Tormenta20.
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/tormenta20`. To experiment with that code, run `bin/console` for an interactive prompt.
+A gem inclui um banco de dados SQLite pré-populado com informações sobre magias, classes, origens, divindades, poderes e equipamentos do sistema Tormenta20.
 
 ## Installation
 
-Install the gem and add to the application's Gemfile by executing:
+Adicione ao Gemfile da sua aplicacao:
+
+```ruby
+gem 'tormenta20'
+```
+
+E execute:
 
 ```bash
-bundle add tormenta20
+bundle install
 ```
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+Ou instale diretamente:
 
 ```bash
 gem install tormenta20
@@ -20,22 +26,207 @@ gem install tormenta20
 
 ## Usage
 
-TODO: Write usage instructions here
+A gem ja vem com o banco de dados populado. Basta fazer require e usar:
+
+```ruby
+require 'tormenta20'
+
+# Magias
+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.arcanas.by_circle("1")   # Combinar filtros
+
+# Classes
+Tormenta20.classes.all
+Tormenta20.classes.conjuradores            # Classes com magia
+
+# Origens
+Tormenta20.origens.all
+Tormenta20.origens.find('soldado')
+Tormenta20.origens.with_unique_power       # Origens com poder unico
+
+# Divindades
+Tormenta20.divindades.all
+Tormenta20.divindades.energia_positiva     # Deuses de energia positiva
+Tormenta20.divindades.energia_negativa     # Deuses de energia negativa
+
+# Poderes
+Tormenta20.poderes.all
+Tormenta20.poderes.habilidades_unicas      # Habilidades unicas de origem
+Tormenta20.poderes.poderes_concedidos      # Poderes concedidos por divindades
+Tormenta20.poderes.poderes_tormenta        # Poderes da Tormenta
+
+# Equipamentos
+Tormenta20.armas.all
+Tormenta20.armas.simples                   # Armas simples
+Tormenta20.armas.marciais                  # Armas marciais
+Tormenta20.armaduras.all
+Tormenta20.armaduras.leves                 # Armaduras leves
+Tormenta20.escudos.all
+
+# Itens Superiores
+Tormenta20.materiais_especiais.all
+
+# Regras
+Tormenta20.regras.all
+```
+
+### Query Interface
+
+A gem oferece uma interface de consulta simplificada. Todos os metodos retornam modelos ActiveRecord, permitindo encadeamento de scopes e queries:
+
+```ruby
+# Accessors disponiveis
+Tormenta20.origens              # => Tormenta20::Models::Origem
+Tormenta20.poderes              # => Tormenta20::Models::Poder
+Tormenta20.divindades           # => Tormenta20::Models::Divindade
+Tormenta20.classes              # => Tormenta20::Models::Classe
+Tormenta20.magias               # => Tormenta20::Models::Magia
+Tormenta20.armas                # => Tormenta20::Models::Arma
+Tormenta20.armaduras            # => Tormenta20::Models::Armadura
+Tormenta20.escudos              # => Tormenta20::Models::Escudo
+Tormenta20.itens                # => Tormenta20::Models::Item
+Tormenta20.materiais_especiais  # => Tormenta20::Models::MaterialEspecial
+Tormenta20.melhorias            # => Tormenta20::Models::Melhoria
+Tormenta20.regras               # => Tormenta20::Models::Regra
+
+# Exemplos de queries ActiveRecord
+Tormenta20.magias.where(type: 'arcana')
+Tormenta20.magias.where(school: 'evoc').order(:name)
+Tormenta20.poderes.where("name LIKE ?", "%Furia%")
+```
+
+### Models Disponiveis
+
+| Model | Descricao | Quantidade | Documentacao |
+|-------|-----------|------------|--------------|
+| `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) |
+| `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) |
+
+> Cada link de documentacao contem a lista completa de atributos, scopes, metodos e exemplos de uso.
+
+### Exemplos
+
+```ruby
+# Buscar uma 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"
+puts bola_de_fogo.description
+
+# Listar poderes de uma divindade
+khalmyr = Tormenta20.divindades.find('khalmyr')
+puts khalmyr.name             # => "Khalmyr"
+puts khalmyr.granted_powers   # => ["coragem_total", "espada_justiceira", ...]
+
+# Buscar poderes concedidos
+Tormenta20.poderes.poderes_concedidos.each do |poder|
+  puts "#{poder.name}: #{poder.deities.join(', ')}"
+end
+
+# Classe com informacoes de magia
+mago = Tormenta20.classes.find('arcanista')
+puts mago.initial_hp          # PV inicial
+puts mago.mp_per_level        # PM por nivel
+puts mago.conjurador?         # => true
+
+# Filtrar magias arcanas do 1o circulo da escola de evocacao
+Tormenta20.magias.arcanas.by_circle("1").by_school("evoc").each do |magia|
+  puts "#{magia.name} - #{magia.description}"
+end
+```
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+### Pre-requisitos
+
+- Ruby >= 3.0.0
+- Bundler
+
+### Setup
+
+```bash
+git clone https://github.com/LuanGB/tormenta20.git
+cd tormenta20
+bundle install
+```
+
+### Construir o Banco de Dados
+
+O banco de dados SQLite e construido a partir dos arquivos JSON em `src/json/`:
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+```bash
+# Construir apenas o banco
+rake build_db
+
+# Build completo da gem (inclui build_db automaticamente)
+rake build
+```
+
+### Estrutura do Projeto
+
+```
+tormenta20/
+├── src/
+│   ├── json/                    # Dados em formato JSON
+│   │   ├── magias/
+│   │   ├── classes/
+│   │   ├── origens/
+│   │   ├── deuses/
+│   │   ├── poderes/
+│   │   │   ├── habilidades_unicas_de_origem/
+│   │   │   ├── poderes_concedidos/
+│   │   │   └── poderes_da_tormenta/
+│   │   ├── equipamentos/
+│   │   ├── itens_superiores/
+│   │   └── regras/
+│   └── ruby/                    # Codigo Ruby
+│       └── tormenta20/
+│           ├── models/          # ActiveRecord models
+│           ├── database.rb      # Conexao com banco
+│           └── seeder.rb        # Import de dados
+├── db/
+│   ├── schema.sql              # Schema SQLite
+│   ├── seeds.rb                # Script de seed (desenvolvimento)
+│   └── tormenta20.sqlite3      # Banco pre-construido (gerado)
+└── bin/
+    └── build_db                # Script de build do banco
+```
+
+### Testes
+
+```bash
+rake spec
+```
+
+### Linting
+
+```bash
+rake rubocop
+```
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/tormenta20. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/tormenta20/blob/master/CODE_OF_CONDUCT.md).
+Bug reports e pull requests sao bem-vindos em https://github.com/LuanGB/tormenta20.
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+Disponivel como open source sob os termos da [MIT License](https://opensource.org/licenses/MIT).
 
-## Code of Conduct
+## Aviso Legal
 
-Everyone interacting in the Tormenta20 project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/tormenta20/blob/master/CODE_OF_CONDUCT.md).
+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.

data/Rakefile

@@ -10,3 +10,12 @@ require "rubocop/rake_task"
 RuboCop::RakeTask.new
 
 task default: %i[spec rubocop]
+
+# Database build task
+desc "Build the SQLite database with all JSON data"
+task :build_db do
+  ruby "bin/build_db"
+end
+
+# Ensure database is built before gem packaging
+Rake::Task[:build].enhance([:build_db])

data/db/schema.sql

@@ -0,0 +1,382 @@
+-- =============================================================================
+-- TORMENTA 20 SQLITE SCHEMA
+-- =============================================================================
+-- Schema para todos os tipos de dados do sistema Tormenta 20
+-- Usa SQLite com JSON para campos flexíveis
+-- =============================================================================
+
+-- -----------------------------------------------------------------------------
+-- ORIGENS (Character Origins)
+-- -----------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS origens (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  description TEXT,
+  items JSON DEFAULT '[]',
+  benefits JSON DEFAULT '{}',
+  unique_power TEXT,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_origens_name ON origens(name);
+
+CREATE TRIGGER IF NOT EXISTS update_origens_timestamp
+AFTER UPDATE ON origens
+BEGIN
+  UPDATE origens SET updated_at = CURRENT_TIMESTAMP WHERE id = NEW.id;
+END;
+
+-- -----------------------------------------------------------------------------
+-- PODERES (Powers) - Tabela unificada para todos os tipos de poderes
+-- -----------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS poderes (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  type TEXT NOT NULL CHECK(type IN (
+    'habilidade_unica_origem',
+    'poder_concedido',
+    'poder_tormenta',
+    'poder_classe',
+    'poder_geral',
+    'poder_combate',
+    'poder_destino',
+    'poder_magia'
+  )),
+  description TEXT,
+  effects JSON DEFAULT '{}',
+  prerequisites JSON DEFAULT '[]',
+  origin_id TEXT,
+  deities JSON DEFAULT '[]',
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_poderes_type ON poderes(type);
+CREATE INDEX IF NOT EXISTS idx_poderes_name ON poderes(name);
+CREATE INDEX IF NOT EXISTS idx_poderes_origin ON poderes(origin_id);
+
+CREATE TRIGGER IF NOT EXISTS update_poderes_timestamp
+AFTER UPDATE ON poderes
+BEGIN
+  UPDATE poderes SET updated_at = CURRENT_TIMESTAMP WHERE id = NEW.id;
+END;
+
+-- -----------------------------------------------------------------------------
+-- DIVINDADES (Deities)
+-- -----------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS divindades (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  title TEXT,
+  description TEXT,
+  beliefs_objectives JSON DEFAULT '[]',
+  holy_symbol TEXT,
+  energy TEXT NOT NULL DEFAULT 'qualquer' CHECK(energy IN ('positiva', 'negativa', 'qualquer')),
+  preferred_weapon TEXT,
+  devotees JSON DEFAULT '{}',
+  granted_powers JSON DEFAULT '[]',
+  obligations_restrictions TEXT,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_divindades_name ON divindades(name);
+CREATE INDEX IF NOT EXISTS idx_divindades_energy ON divindades(energy);
+
+CREATE TRIGGER IF NOT EXISTS update_divindades_timestamp
+AFTER UPDATE ON divindades
+BEGIN
+  UPDATE divindades SET updated_at = CURRENT_TIMESTAMP WHERE id = NEW.id;
+END;
+
+-- -----------------------------------------------------------------------------
+-- CLASSES (Character Classes)
+-- -----------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS classes (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  hit_points JSON NOT NULL,
+  mana_points JSON NOT NULL,
+  skills JSON NOT NULL,
+  proficiencies JSON NOT NULL,
+  abilities JSON DEFAULT '[]',
+  powers JSON DEFAULT '[]',
+  progression JSON DEFAULT '[]',
+  spellcasting JSON,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_classes_name ON classes(name);
+
+CREATE TRIGGER IF NOT EXISTS update_classes_timestamp
+AFTER UPDATE ON classes
+BEGIN
+  UPDATE classes SET updated_at = CURRENT_TIMESTAMP WHERE id = NEW.id;
+END;
+
+-- -----------------------------------------------------------------------------
+-- MAGIAS (Spells)
+-- -----------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS magias (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  type TEXT NOT NULL CHECK(type IN ('arcana', 'divina', 'universal')),
+  circle TEXT NOT NULL,
+  school TEXT NOT NULL CHECK(school IN ('abjur', 'adiv', 'conv', 'encan', 'evoc', 'ilus', 'necro', 'trans')),
+  execution TEXT NOT NULL,
+  execution_details TEXT,
+  range TEXT NOT NULL,
+  duration TEXT NOT NULL,
+  duration_details TEXT,
+  counterspell TEXT,
+  description TEXT NOT NULL,
+
+  -- Target information
+  target_amount INTEGER,
+  target_up_to INTEGER,
+  target_type TEXT,
+
+  -- Effect information
+  effect TEXT,
+  effect_shape TEXT,
+  effect_dimention TEXT,
+  effect_size TEXT,
+  effect_other_details TEXT,
+
+  -- Alternative effect fields
+  area_effect TEXT,
+  area_effect_details TEXT,
+
+  -- Resistance information
+  resistence_effect TEXT,
+  resistence_skill TEXT,
+
+  -- Extra costs
+  extra_costs_material_component TEXT,
+  extra_costs_material_cost TEXT,
+  extra_costs_pm_debuff TEXT,
+  extra_costs_pm_sacrifice TEXT,
+
+  -- Complex nested data stored as JSON
+  enhancements JSON NOT NULL DEFAULT '[]',
+  effects JSON NOT NULL DEFAULT '[]',
+
+  -- Metadata
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_magias_type ON magias(type);
+CREATE INDEX IF NOT EXISTS idx_magias_circle ON magias(circle);
+CREATE INDEX IF NOT EXISTS idx_magias_school ON magias(school);
+CREATE INDEX IF NOT EXISTS idx_magias_name ON magias(name);
+
+CREATE TRIGGER IF NOT EXISTS update_magias_timestamp
+AFTER UPDATE ON magias
+BEGIN
+  UPDATE magias SET updated_at = CURRENT_TIMESTAMP WHERE id = NEW.id;
+END;
+
+-- -----------------------------------------------------------------------------
+-- EQUIPAMENTOS - ARMAS (Weapons)
+-- -----------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS armas (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  category TEXT NOT NULL CHECK(category IN ('simples', 'marciais', 'exoticas', 'fogo')),
+  price INTEGER,
+  damage TEXT,
+  damage_type TEXT,
+  critical TEXT,
+  range TEXT,
+  weight REAL,
+  properties JSON DEFAULT '[]',
+  description TEXT,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_armas_category ON armas(category);
+CREATE INDEX IF NOT EXISTS idx_armas_name ON armas(name);
+
+CREATE TRIGGER IF NOT EXISTS update_armas_timestamp
+AFTER UPDATE ON armas
+BEGIN
+  UPDATE armas SET updated_at = CURRENT_TIMESTAMP WHERE id = NEW.id;
+END;
+
+-- -----------------------------------------------------------------------------
+-- EQUIPAMENTOS - ARMADURAS (Armors)
+-- -----------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS armaduras (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  category TEXT NOT NULL CHECK(category IN ('leve', 'pesada')),
+  price INTEGER,
+  defense_bonus INTEGER NOT NULL,
+  armor_penalty INTEGER DEFAULT 0,
+  weight REAL,
+  properties JSON DEFAULT '[]',
+  description TEXT,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_armaduras_category ON armaduras(category);
+CREATE INDEX IF NOT EXISTS idx_armaduras_name ON armaduras(name);
+
+CREATE TRIGGER IF NOT EXISTS update_armaduras_timestamp
+AFTER UPDATE ON armaduras
+BEGIN
+  UPDATE armaduras SET updated_at = CURRENT_TIMESTAMP WHERE id = NEW.id;
+END;
+
+-- -----------------------------------------------------------------------------
+-- EQUIPAMENTOS - ESCUDOS (Shields)
+-- -----------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS escudos (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  price INTEGER,
+  defense_bonus INTEGER NOT NULL,
+  armor_penalty INTEGER DEFAULT 0,
+  weight REAL,
+  properties JSON DEFAULT '[]',
+  description TEXT,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_escudos_name ON escudos(name);
+
+CREATE TRIGGER IF NOT EXISTS update_escudos_timestamp
+AFTER UPDATE ON escudos
+BEGIN
+  UPDATE escudos SET updated_at = CURRENT_TIMESTAMP WHERE id = NEW.id;
+END;
+
+-- -----------------------------------------------------------------------------
+-- EQUIPAMENTOS - ITENS GERAIS (General Items)
+-- -----------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS itens (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  category TEXT,
+  price INTEGER,
+  weight REAL,
+  description TEXT,
+  effects JSON DEFAULT '{}',
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_itens_category ON itens(category);
+CREATE INDEX IF NOT EXISTS idx_itens_name ON itens(name);
+
+CREATE TRIGGER IF NOT EXISTS update_itens_timestamp
+AFTER UPDATE ON itens
+BEGIN
+  UPDATE itens SET updated_at = CURRENT_TIMESTAMP WHERE id = NEW.id;
+END;
+
+-- -----------------------------------------------------------------------------
+-- ITENS SUPERIORES - MATERIAIS ESPECIAIS (Special Materials)
+-- -----------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS materiais_especiais (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  description TEXT,
+  applicable_to JSON DEFAULT '[]',
+  price_modifier JSON,
+  effects JSON DEFAULT '{}',
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_materiais_especiais_name ON materiais_especiais(name);
+
+CREATE TRIGGER IF NOT EXISTS update_materiais_especiais_timestamp
+AFTER UPDATE ON materiais_especiais
+BEGIN
+  UPDATE materiais_especiais SET updated_at = CURRENT_TIMESTAMP WHERE id = NEW.id;
+END;
+
+-- -----------------------------------------------------------------------------
+-- ITENS SUPERIORES - MELHORIAS (Enhancements)
+-- -----------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS melhorias (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  description TEXT,
+  applicable_to JSON DEFAULT '[]',
+  price INTEGER,
+  effects JSON DEFAULT '{}',
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_melhorias_name ON melhorias(name);
+
+CREATE TRIGGER IF NOT EXISTS update_melhorias_timestamp
+AFTER UPDATE ON melhorias
+BEGIN
+  UPDATE melhorias SET updated_at = CURRENT_TIMESTAMP WHERE id = NEW.id;
+END;
+
+-- -----------------------------------------------------------------------------
+-- REGRAS (Rules/Reference Data)
+-- -----------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS regras (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  description TEXT,
+  data JSON NOT NULL,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_regras_name ON regras(name);
+
+CREATE TRIGGER IF NOT EXISTS update_regras_timestamp
+AFTER UPDATE ON regras
+BEGIN
+  UPDATE regras SET updated_at = CURRENT_TIMESTAMP WHERE id = NEW.id;
+END;
+
+-- =============================================================================
+-- VIEWS ÚTEIS
+-- =============================================================================
+
+-- View de resumo de magias
+CREATE VIEW IF NOT EXISTS magias_summary AS
+SELECT
+  id,
+  name,
+  type,
+  circle,
+  school,
+  execution,
+  range,
+  duration
+FROM magias;
+
+-- View de poderes por tipo
+CREATE VIEW IF NOT EXISTS poderes_por_tipo AS
+SELECT
+  type,
+  COUNT(*) as total,
+  GROUP_CONCAT(name, ', ') as nomes
+FROM poderes
+GROUP BY type;
+
+-- View de divindades com contagem de poderes
+CREATE VIEW IF NOT EXISTS divindades_resumo AS
+SELECT
+  d.id,
+  d.name,
+  d.title,
+  d.energy,
+  json_array_length(d.granted_powers) as total_poderes
+FROM divindades d;