Rails Architect

🏗️ Uma gem Ruby para análise completa de projetos Rails com foco em arquitetura, TDD, BDD e princípios SOLID.

• 📐 Análise de Arquitetura: Verifica a estrutura padrão do Rails e recomenda padrões opcionais
• 🧪 Análise TDD: Avalia cobertura de testes e sugere melhorias
• 🎯 Análise BDD: Identifica funcionalidades BDD com Cucumber e RSpec
• ⚡ Análise SOLID: Avalia cada princípio SOLID do seu código
• 💡 Sugestões Inteligentes: Recomendações específicas para seu projeto
• 📊 Relatórios Detalhados: Saída colorida e JSON exportável

Adicione à seu Gemfile:

gem 'rails_architect_analyzer'

Depois execute:

bundle install

Analisar seu projeto Rails atual:

rails_architect analyze

Analisar um projeto específico:

rails_architect analyze /caminho/para/seu/projeto

Obter sugestões de arquitetura:

rails_architect suggest

Salvar relatório em JSON:

rails_architect analyze --json --output report.json

Salvar relatório em arquivo de texto:

rails_architect analyze --output report.txt

# Analisar projeto atual
results = RailsArchitect.analyze

# Analisar projeto específico
results = RailsArchitect.analyze('/caminho/para/seu/projeto')

# Acessar resultados específicos
results[:architecture][:score]      # Score de arquitetura (0-100)
results[:tdd][:score][:score]       # Score de cobertura TDD
results[:bdd][:score][:rating]      # Rating de BDD
results[:solid][:score][:score]     # Score SOLID (0-100)

• Estrutura padrão de diretórios
• Padrões opcionais (Services, Decorators, Policies, Presenters, Interactors, etc.)
• Detecção de "fat models" e "fat controllers"
• Qualidade de organização de helpers

• Cobertura de testes (modelo de estimativa)
• Número de testes por tipo (models, controllers, services, etc.)
• Uso de RSpec vs Minitest
• Sugestões para melhorar cobertura

• Presença de Cucumber
• Número de feature files e step definitions
• Análise de cenários legíveis (Given/When/Then)
• Testes de integração (request specs)

1. Single Responsibility: Detecta classes com múltiplas responsabilidades
2. Open/Closed: Verifica uso de concerns e herança
3. Liskov Substitution: Analisa cadeias de herança
4. Interface Segregation: Detecta módulos e classes muito grandes
5. Dependency Inversion: Avalia uso de service layer e injeção de dependência

================================================================================
🏗️  RAILS ARCHITECT - PROJECT ANALYSIS REPORT
================================================================================

📐 ARCHITECTURE ANALYSIS
────────────────────────────────────────────────────────────────────────────────
Overall Score: 65%

✓ Existing Directories (9/10):
  ✅ app/models (8 files)
  ✅ app/controllers (12 files)
  ✅ app/views (45 files)
  ...

💡 Suggestions:
  • Consider creating 'app/services' directory for business logic
  • Create 'app/decorators' for separating presentation logic from models
  ...

🧪 TEST-DRIVEN DEVELOPMENT (TDD) ANALYSIS
────────────────────────────────────────────────────────────────────────────────
Coverage Score: 45.5% ⚠️  Fair

Test Files:
  • Spec files: 28
  • Test files: 0
  • Total: 28

...

A gem funciona out-of-the-box. Coloque na raiz do seu projeto Rails:

# config/initializers/rails_architect.rb (opcional)
# Configurações futuras

# app/services/user_creator.rb
class UserCreator
  def initialize(user_params)
    @user_params = user_params
  end

  def call
    User.create(@user_params)
  end
end

# Uso
UserCreator.new(params).call

# app/decorators/user_decorator.rb
class UserDecorator
  def initialize(user)
    @user = user
  end

  def full_name_with_email
    "#{@user.full_name} <#{@user.email}>"
  end
end

# app/concerns/timestampable.rb
module Timestampable
  extend ActiveSupport::Concern

  included do
    before_save :update_timestamps
  end

  def update_timestamps
    self.updated_at = Time.current
  end
end

# app/policies/post_policy.rb
class PostPolicy
  def initialize(user, post)
    @user = user
    @post = post
  end

  def update?
    @user == @post.author
  end
end

# app/presenters/dashboard_presenter.rb
class DashboardPresenter
  def initialize(user)
    @user = user
  end

  def total_posts
    @user.posts.count
  end
end

• Análise de performance
• Detecção de code smells
• Sugestões de gems para padrões
• Integração com CI/CD
• Dashboard web
• Comparação entre projetos
• Análise histórica

1. Faça um fork
2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
4. Push para a branch (git push origin feature/AmazingFeature)
5. Abra um Pull Request

MIT License - veja LICENSE.md para detalhes

• Versão inicial com análise de arquitetura, TDD, BDD e SOLID
• CLI completa com múltiplas opções de saída
• Relatórios detalhados e coloridos

Daniel Matos - @daniel8486

Para reportar bugs ou sugerir features, abra uma issue no GitHub.