Auditoria de bugs + suíte de testes RSpec

Correções:
- Erro de sintaxe em Admin::Usuarios#toggle_ativo (entidade: \'User\') que
  derrubava /admin/usuarios
- Migration fase2 readicionava coluna `ativo` sem guard (db:migrate do zero
  quebrava); db:seed colidia no índice único de email para motoristas
- Dashboard e HistoricoEstimado agora aplicam .da_conta_gade
- ConsolidacaoMotorista#recalcular_valor usa valor_aplicado (fonte única)
- Gate de finalização por motorista (antes soma agregada com >=) e validação
  de elegibilidade em classificar/classificar_em_massa
- Remove coluna órfã pin_acesso; registra autor do arquivamento
  (arquivado_por/arquivado_em + belongs_to :arquivador)
- Dashboard redireciona motorista; Date.parse tolerante
- Remove MotoristaController + view órfãos (não roteados e quebrados)

Testes: infra RSpec + factories + specs de models, policy e request.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

spec/factories.rb

@@ -0,0 +1,55 @@
+FactoryBot.define do
+  factory :user do
+    sequence(:nome) { |n| "Usuario Teste #{n}" }
+    sequence(:email) { |n| "user#{n}@gade.com" }
+    password { 'Gade@2026!' }
+    role { :operador }
+    ativo { true }
+
+    factory :admin   do role { :admin }   end
+    factory :gerente do role { :gerente } end
+    factory :operador do role { :operador } end
+
+    factory :motorista do
+      role { :motorista }
+      # email é NOT NULL + único no banco; motorista real não tem e-mail, então
+      # usamos um placeholder único (mesma estratégia do db/seeds.rb).
+      sequence(:email) { |n| "motorista#{n}@motorista.local" }
+      password { nil }
+      sequence(:nome) { |n| "Motorista #{n}" }
+      sequence(:pin_code) { |n| format('%04d', n % 10000) }
+    end
+  end
+
+  factory :configuracao do
+    chave { 'empresa_nome' }
+    valor { 'Reem Transporte' }
+  end
+
+  factory :consolidacao do
+    sequence(:nome) { |n| "Consolidacao #{n}" }
+    data_inicio { Date.new(2026, 6, 1) }
+    data_fim    { Date.new(2026, 6, 30) }
+    association :criador, factory: :gerente
+    status { :rascunho }
+  end
+
+  factory :consolidacao_motorista do
+    association :consolidacao
+    sequence(:motorista_nome) { |n| "Motorista #{n}" }
+  end
+
+  factory :consolidacao_entrega do
+    association :consolidacao
+    sequence(:tracking_id) { |n| "TRK-#{n}" }
+    motorista_nome { 'Joao Silva' }
+    tipo { :entrega_normal }
+    valor_aplicado { 15.0 }
+  end
+
+  factory :historico_estimado do
+    data_hora { Time.current }
+    valor_total_estimado { 150.0 }
+    entregas_contadas { 10 }
+  end
+end

spec/models/auditoria_log_spec.rb

@@ -0,0 +1,24 @@
+require 'rails_helper'
+
+RSpec.describe AuditoriaLog, type: :model do
+  describe '.registrar' do
+    it 'cria um log com os dados informados' do
+      user = create(:admin)
+      expect {
+        AuditoriaLog.registrar(user: user, acao: :login, entidade: 'User', entidade_id: user.id)
+      }.to change(AuditoriaLog, :count).by(1)
+
+      log = AuditoriaLog.last
+      expect(log.acao).to eq('login')
+      expect(log.entidade).to eq('User')
+      expect(log.user_id).to eq(user.id)
+    end
+
+    it 'não levanta exceção quando a gravação falha (apenas loga)' do
+      allow(AuditoriaLog).to receive(:create!).and_raise(StandardError, 'boom')
+      expect {
+        AuditoriaLog.registrar(user: nil, acao: :login, entidade: 'User')
+      }.not_to raise_error
+    end
+  end
+end

spec/models/configuracao_spec.rb

@@ -0,0 +1,46 @@
+require 'rails_helper'
+
+RSpec.describe Configuracao, type: :model do
+  describe 'validações' do
+    it 'só aceita chaves conhecidas' do
+      expect(build(:configuracao, chave: 'chave_invalida')).not_to be_valid
+    end
+
+    it 'exige valor' do
+      expect(build(:configuracao, valor: nil)).not_to be_valid
+    end
+
+    it 'não permite chave duplicada' do
+      create(:configuracao, chave: 'empresa_nome')
+      expect(build(:configuracao, chave: 'empresa_nome')).not_to be_valid
+    end
+  end
+
+  describe 'helpers de preço' do
+    before do
+      create(:configuracao, chave: 'preco_entrega',  valor: '15.00')
+      create(:configuracao, chave: 'preco_retirada', valor: '20.00')
+    end
+
+    it 'converte o valor armazenado em float' do
+      expect(Configuracao.preco_entrega).to eq(15.0)
+      expect(Configuracao.preco_retirada).to eq(20.0)
+    end
+
+    it 'retorna 0.0 quando a chave não existe' do
+      expect(Configuracao.preco_bonus).to eq(0.0)
+    end
+  end
+
+  describe '#valor_formatado' do
+    it 'formata chaves de moeda em reais' do
+      cfg = build(:configuracao, chave: 'preco_entrega', valor: '15.5')
+      expect(cfg.valor_formatado).to eq('R$ 15,50')
+    end
+
+    it 'devolve o valor cru para chaves não-monetárias' do
+      cfg = build(:configuracao, chave: 'empresa_nome', valor: 'Reem')
+      expect(cfg.valor_formatado).to eq('Reem')
+    end
+  end
+end

spec/models/consolidacao_entrega_spec.rb

@@ -0,0 +1,37 @@
+require 'rails_helper'
+
+RSpec.describe ConsolidacaoEntrega, type: :model do
+  describe 'validações' do
+    it 'exige tracking_id, motorista_nome, tipo e valor_aplicado' do
+      ce = ConsolidacaoEntrega.new
+      ce.valid?
+      expect(ce.errors[:tracking_id]).to be_present
+      expect(ce.errors[:motorista_nome]).to be_present
+      expect(ce.errors[:valor_aplicado]).to be_present
+    end
+
+    it 'rejeita valor_aplicado negativo' do
+      expect(build(:consolidacao_entrega, valor_aplicado: -1)).not_to be_valid
+    end
+
+    it 'exige tracking_id único por consolidação' do
+      consolidacao = create(:consolidacao)
+      create(:consolidacao_entrega, consolidacao: consolidacao, tracking_id: 'TRK-1')
+      dup = build(:consolidacao_entrega, consolidacao: consolidacao, tracking_id: 'TRK-1')
+      expect(dup).not_to be_valid
+    end
+
+    it 'permite o mesmo tracking_id em consolidações diferentes' do
+      create(:consolidacao_entrega, tracking_id: 'TRK-X')
+      outra = build(:consolidacao_entrega, tracking_id: 'TRK-X')
+      expect(outra).to be_valid
+    end
+  end
+
+  describe '#tipo_cor' do
+    it 'retorna o mapa de cores do tipo' do
+      ce = build(:consolidacao_entrega, tipo: :retirada)
+      expect(ce.tipo_cor[:label]).to eq('Retirada')
+    end
+  end
+end

spec/models/consolidacao_motorista_spec.rb

@@ -0,0 +1,49 @@
+require 'rails_helper'
+
+RSpec.describe ConsolidacaoMotorista, type: :model do
+  describe 'validações' do
+    it 'exige motorista_nome' do
+      expect(build(:consolidacao_motorista, motorista_nome: nil)).not_to be_valid
+    end
+
+    it 'não permite o mesmo motorista duas vezes na consolidação' do
+      consolidacao = create(:consolidacao)
+      create(:consolidacao_motorista, consolidacao: consolidacao, motorista_nome: 'Joao')
+      dup = build(:consolidacao_motorista, consolidacao: consolidacao, motorista_nome: 'Joao')
+      expect(dup).not_to be_valid
+    end
+  end
+
+  describe '#recalcular_valor (fonte única: valor_aplicado)' do
+    let(:consolidacao) { create(:consolidacao) }
+
+    before do
+      create(:consolidacao_entrega, consolidacao: consolidacao, motorista_nome: 'Joao',
+                                    tipo: :entrega_normal, valor_aplicado: 15)
+      create(:consolidacao_entrega, consolidacao: consolidacao, motorista_nome: 'Joao',
+                                    tipo: :bonus, valor_aplicado: 10)
+      create(:consolidacao_entrega, consolidacao: consolidacao, motorista_nome: 'Joao',
+                                    tipo: :desconto, valor_aplicado: 5)
+    end
+
+    it 'soma usando valor_aplicado e trata desconto como negativo' do
+      cm = create(:consolidacao_motorista, consolidacao: consolidacao, motorista_nome: 'Joao')
+      # 15 + 10 - 5 = 20
+      expect(cm.valor_total).to eq(20)
+    end
+
+    it 'NÃO recalcula pelos preços atuais de Configuracao' do
+      # Mesmo que os preços de Configuracao mudem, o total usa o valor_aplicado capturado.
+      allow(Configuracao).to receive(:preco_entrega).and_return(999)
+      cm = create(:consolidacao_motorista, consolidacao: consolidacao, motorista_nome: 'Joao')
+      expect(cm.valor_total).to eq(20)
+    end
+
+    it 'considera apenas as entregas do próprio motorista' do
+      create(:consolidacao_entrega, consolidacao: consolidacao, motorista_nome: 'Maria',
+                                    tipo: :entrega_normal, valor_aplicado: 100)
+      cm = create(:consolidacao_motorista, consolidacao: consolidacao, motorista_nome: 'Joao')
+      expect(cm.valor_total).to eq(20)
+    end
+  end
+end

spec/models/consolidacao_spec.rb

@@ -0,0 +1,102 @@
+require 'rails_helper'
+
+RSpec.describe Consolidacao, type: :model do
+  describe 'validação de período' do
+    it 'rejeita data_fim anterior a data_inicio' do
+      c = build(:consolidacao, data_inicio: Date.new(2026, 6, 10), data_fim: Date.new(2026, 6, 1))
+      expect(c).not_to be_valid
+      expect(c.errors[:data_fim]).to be_present
+    end
+
+    it 'aceita período válido' do
+      expect(build(:consolidacao)).to be_valid
+    end
+  end
+
+  describe '#recalcular_valor_total (before_save)' do
+    it 'soma os valores dos motoristas da consolidação' do
+      consolidacao = create(:consolidacao)
+      create(:consolidacao_motorista, consolidacao: consolidacao, motorista_nome: 'A')
+      create(:consolidacao_motorista, consolidacao: consolidacao, motorista_nome: 'B')
+      consolidacao.consolidacao_motoristas.update_all(valor_total: 30)
+
+      consolidacao.save!
+      expect(consolidacao.reload.valor_total).to eq(60)
+    end
+  end
+
+  describe '#finalizar!' do
+    let(:consolidacao) { create(:consolidacao) }
+    let(:gerente)      { create(:gerente) }
+
+    it 'não finaliza quando há entregas não classificadas' do
+      allow(consolidacao).to receive(:todas_entregas_classificadas?).and_return(false)
+      expect(consolidacao.finalizar!(gerente)).to be_falsey
+      expect(consolidacao.reload).to be_rascunho
+    end
+
+    it 'finaliza e registra finalizador quando tudo está classificado' do
+      allow(consolidacao).to receive(:todas_entregas_classificadas?).and_return(true)
+      consolidacao.finalizar!(gerente)
+      consolidacao.reload
+      expect(consolidacao).to be_finalizada
+      expect(consolidacao.finalizado_por).to eq(gerente.id)
+      expect(consolidacao.finalizado_em).to be_present
+    end
+  end
+
+  describe '#arquivar!' do
+    it 'marca deleted_at, status arquivada e registra quem arquivou' do
+      gerente = create(:gerente)
+      consolidacao = create(:consolidacao)
+      consolidacao.arquivar!(gerente)
+      consolidacao.reload
+      expect(consolidacao).to be_arquivada
+      expect(consolidacao.deleted_at).to be_present
+      expect(consolidacao.arquivado_por).to eq(gerente.id)
+      expect(consolidacao.arquivado_em).to be_present
+      expect(consolidacao.arquivador).to eq(gerente)
+    end
+  end
+
+  describe '#todas_entregas_classificadas? (gate por motorista)' do
+    let(:consolidacao) { create(:consolidacao) }
+
+    before do
+      create(:consolidacao_motorista, consolidacao: consolidacao, motorista_nome: 'A')
+      create(:consolidacao_motorista, consolidacao: consolidacao, motorista_nome: 'B')
+    end
+
+    it 'é falso quando UM motorista tem pendências, mesmo que outro tenha entregas de sobra' do
+      allow(consolidacao).to receive(:entregas_elegiveis_count).and_return(2)
+      # A: 0 classificadas | B: 4 classificadas. A soma agregada (4 >= 4) passaria,
+      # mas a checagem por motorista deve reprovar.
+      create_list(:consolidacao_entrega, 4, consolidacao: consolidacao, motorista_nome: 'B')
+      expect(consolidacao.todas_entregas_classificadas?).to be false
+    end
+
+    it 'é verdadeiro quando cada motorista está completo' do
+      allow(consolidacao).to receive(:entregas_elegiveis_count).and_return(1)
+      create(:consolidacao_entrega, consolidacao: consolidacao, motorista_nome: 'A')
+      create(:consolidacao_entrega, consolidacao: consolidacao, motorista_nome: 'B')
+      expect(consolidacao.todas_entregas_classificadas?).to be true
+    end
+
+    it 'ignora motoristas sem entregas elegíveis (total zero)' do
+      allow(consolidacao).to receive(:entregas_elegiveis_count).and_return(0)
+      expect(consolidacao.todas_entregas_classificadas?).to be true
+    end
+  end
+
+  describe 'escopos de soft delete' do
+    it 'separa ativas de arquivadas' do
+      ativa     = create(:consolidacao)
+      arquivada = create(:consolidacao)
+      arquivada.arquivar!(create(:gerente))
+
+      expect(Consolidacao.ativas).to include(ativa)
+      expect(Consolidacao.ativas).not_to include(arquivada)
+      expect(Consolidacao.arquivadas).to include(arquivada)
+    end
+  end
+end

spec/models/user_spec.rb

@@ -0,0 +1,60 @@
+require 'rails_helper'
+
+RSpec.describe User, type: :model do
+  describe 'validações de nome' do
+    it 'exige nome com ao menos 3 caracteres' do
+      user = build(:operador, nome: 'ab')
+      expect(user).not_to be_valid
+      expect(user.errors[:nome]).to be_present
+    end
+  end
+
+  describe 'e-mail e senha por papel' do
+    it 'exige e-mail para não-motoristas' do
+      expect(build(:operador).email_required?).to be true
+      expect(build(:operador, email: nil)).not_to be_valid
+    end
+
+    it 'NÃO exige e-mail nem senha para motoristas (login por PIN)' do
+      motorista = build(:motorista, email: nil, password: nil)
+      expect(motorista.email_required?).to be false
+      expect(motorista.password_required?).to be false
+      expect(motorista).to be_valid
+    end
+  end
+
+  describe 'validação de PIN (somente motoristas)' do
+    it 'aceita PIN de 4 dígitos numéricos' do
+      expect(build(:motorista, pin_code: '0420')).to be_valid
+    end
+
+    it 'rejeita PIN com tamanho diferente de 4' do
+      expect(build(:motorista, pin_code: '123')).not_to be_valid
+    end
+
+    it 'rejeita PIN não numérico' do
+      expect(build(:motorista, pin_code: '12ab')).not_to be_valid
+    end
+
+    it 'ignora a validação de PIN para não-motoristas' do
+      expect(build(:operador, pin_code: 'xyz')).to be_valid
+    end
+  end
+
+  describe 'PIN único entre motoristas' do
+    it 'impede dois motoristas com o mesmo PIN' do
+      create(:motorista, pin_code: '4242')
+      duplicado = build(:motorista, pin_code: '4242')
+      expect(duplicado).not_to be_valid
+      expect(duplicado.errors[:pin_code]).to be_present
+    end
+  end
+
+  describe '#regenerar_login_token!' do
+    it 'gera e persiste um token novo' do
+      motorista = create(:motorista)
+      expect { motorista.regenerar_login_token! }
+        .to change { motorista.reload.login_token }.from(nil)
+    end
+  end
+end

spec/policies/consolidacao_policy_spec.rb

@@ -0,0 +1,42 @@
+require 'rails_helper'
+
+RSpec.describe ConsolidacaoPolicy do
+  subject { described_class }
+
+  let(:consolidacao)            { build(:consolidacao, status: :rascunho) }
+  let(:consolidacao_finalizada) { build(:consolidacao, status: :finalizada) }
+
+  permissions :index?, :show?, :create? do
+    it 'libera para admin, gerente e operador' do
+      %i[admin gerente operador].each do |papel|
+        expect(subject).to permit(build(papel), Consolidacao)
+      end
+    end
+
+    it 'nega para motorista' do
+      expect(subject).not_to permit(build(:motorista), Consolidacao)
+    end
+  end
+
+  permissions :update? do
+    it 'permite operador editar rascunho' do
+      expect(subject).to permit(build(:operador), consolidacao)
+    end
+
+    it 'impede operador de editar consolidação finalizada' do
+      expect(subject).not_to permit(build(:operador), consolidacao_finalizada)
+    end
+
+    it 'permite gerente editar consolidação finalizada' do
+      expect(subject).to permit(build(:gerente), consolidacao_finalizada)
+    end
+  end
+
+  permissions :destroy? do
+    it 'só permite admin e gerente' do
+      expect(subject).to permit(build(:admin), consolidacao)
+      expect(subject).to permit(build(:gerente), consolidacao)
+      expect(subject).not_to permit(build(:operador), consolidacao)
+    end
+  end
+end

spec/rails_helper.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+ENV['RAILS_ENV'] ||= 'test'
+require_relative '../config/environment'
+
+abort("The Rails environment is running in production mode!") if Rails.env.production?
+
+require 'rspec/rails'
+
+# Carrega os arquivos de suporte (factories etc.)
+Dir[Rails.root.join('spec', 'support', '**', '*.rb')].sort.each { |f| require f }
+
+# NÃO usamos maintain_test_schema! porque o projeto não versiona schema.rb
+# (as migrations são a fonte de verdade). Rode antes da suíte:
+#   RAILS_ENV=test bundle exec rails db:create db:migrate
+RSpec.configure do |config|
+  config.fixture_paths = [Rails.root.join('spec', 'fixtures')] if config.respond_to?(:fixture_paths)
+  config.use_transactional_fixtures = true
+  config.infer_spec_type_from_file_location!
+  config.filter_rails_from_backtrace!
+
+  config.include FactoryBot::Syntax::Methods
+end

spec/requests/dashboard_spec.rb

@@ -0,0 +1,14 @@
+require 'rails_helper'
+
+RSpec.describe 'Dashboard', type: :request do
+  it 'redireciona usuário não autenticado para o login' do
+    get dashboard_path
+    expect(response).to redirect_to(new_user_session_path)
+  end
+
+  it 'redireciona motorista para o painel exclusivo de motorista' do
+    sign_in create(:motorista)
+    get dashboard_path
+    expect(response).to redirect_to(motorista_dashboard_path)
+  end
+end

spec/spec_helper.rb

@@ -0,0 +1,16 @@
+RSpec.configure do |config|
+  config.expect_with :rspec do |expectations|
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  config.mock_with :rspec do |mocks|
+    mocks.verify_partial_doubles = true
+  end
+
+  config.shared_context_metadata_behavior = :apply_to_host_groups
+  config.filter_run_when_matching :focus
+  config.example_status_persistence_file_path = "spec/examples.txt"
+  config.disable_monkey_patching!
+  config.order = :random
+  Kernel.srand config.seed
+end

spec/support/devise.rb

@@ -0,0 +1,4 @@
+RSpec.configure do |config|
+  config.include Devise::Test::IntegrationHelpers, type: :request
+  config.include Devise::Test::ControllerHelpers,  type: :controller
+end

spec/support/pundit.rb

@@ -0,0 +1 @@
+require 'pundit/rspec'