Correção de horario e implantação da geração de Romaneio

spec/services/romaneios/enriquecimento_gade_spec.rb

@@ -0,0 +1,47 @@
+require 'rails_helper'
+
+# É o que dispensa a SEGUNDA PLANILHA do programa Python: o STATUS (NOVO/RECORRENTE)
+# já está na tabela da operação.
+RSpec.describe Romaneios::EnriquecimentoGade do
+  include_context 'tabela de operação'
+
+  let(:tabela) { "#{Operacao::PREFIXO}teste_jan_2026" }
+
+  it 'marca APARELHO = SIM só para quem está como NOVO' do
+    criar_operacao!(tabela)
+    semear_operacao!(tabela, [
+                       { nota_fiscal: '1', nome_completo: 'Novo Paciente', telefones: '(11) 1',
+                         status: 'NOVO' },
+                       { nota_fiscal: '2', nome_completo: 'Velho Paciente', telefones: '(11) 2',
+                         status: 'RECORRENTE' }
+                     ])
+
+    dados = described_class.new(tabela).para_notas(%w[1 2])
+
+    expect(dados['1'][:aparelho]).to eq('SIM')
+    expect(dados['2'][:aparelho]).to eq('')
+    expect(dados['1'][:nome]).to eq('NOVO PACIENTE')
+    expect(dados['2'][:telefones]).to eq('(11) 2')
+  end
+
+  it 'não quebra quando a operação não tem a coluna status — e AVISA qual falta' do
+    criar_operacao!(tabela, colunas: %i[nome_completo telefones])
+    semear_operacao!(tabela, [{ nota_fiscal: '1', nome_completo: 'Fulano', telefones: '(11) 1' }])
+
+    servico = described_class.new(tabela)
+
+    expect(servico.colunas_ausentes).to eq(['status'])
+    expect(servico.para_notas(['1'])['1'][:aparelho]).to eq('')
+  end
+
+  it 'omite a NF que não está na operação (é o plano avulso / de inclusão)' do
+    criar_operacao!(tabela)
+    semear_operacao!(tabela, [{ nota_fiscal: '1', status: 'NOVO' }])
+
+    expect(described_class.new(tabela).para_notas(%w[1 999])).not_to have_key('999')
+  end
+
+  it 'recusa nome de tabela fora da whitelist de operações' do
+    expect { described_class.new('users; DROP TABLE users') }.to raise_error(ArgumentError)
+  end
+end

spec/services/romaneios/importador_spec.rb

@@ -0,0 +1,115 @@
+require 'rails_helper'
+
+# As regras de reconciliação — é onde mora o risco da funcionalidade: errar aqui
+# significa ou perder a correção que o operador fez à mão, ou imprimir um endereço
+# velho que o SimpliRoute já corrigiu.
+RSpec.describe Romaneios::Importador do
+  let(:romaneio) { create(:romaneio) }
+
+  def linha_do_plano(nf:, nome: 'FULANO', endereco: 'RUA A, 1', telefones: '(11) 1111-1111',
+                     veiculo: 'GADE_001', ordem: 1)
+    { veiculo: veiculo, ordem: ordem, motorista: '', nota_fiscal: nf, nome: nome,
+      endereco: endereco, telefones: telefones, aparelho: '', tracking_id: '',
+      titulo: "NF #{nf} - #{nome}" }
+  end
+
+  def importar(linhas)
+    described_class.new(romaneio: romaneio, linhas: linhas, origem: 'planilha').aplicar!
+  end
+
+  it 'insere as paradas novas e cria a folha de cada veículo' do
+    resultado = importar([linha_do_plano(nf: '1'),
+                          linha_do_plano(nf: '2', veiculo: 'GADE_002', ordem: 1)])
+
+    expect(resultado.novos).to eq(2)
+    expect(romaneio.romaneio_linhas.count).to eq(2)
+    expect(romaneio.romaneio_veiculos.pluck(:veiculo)).to contain_exactly('GADE_001', 'GADE_002')
+  end
+
+  it 'PRESERVA o campo que o operador editou e atualiza os demais' do
+    importar([linha_do_plano(nf: '1', nome: 'FULANO', endereco: 'RUA A, 1')])
+    linha = romaneio.romaneio_linhas.first
+    linha.telefones = '(11) 99999-0000'
+    linha.marcar_editado!('telefones')
+    linha.save!
+
+    resultado = importar([linha_do_plano(nf: '1', nome: 'FULANO DE TAL',
+                                         endereco: 'RUA B, 2', telefones: '(11) 1111-1111')])
+
+    linha.reload
+    expect(linha.telefones).to eq('(11) 99999-0000')  # intocado: tem edição humana
+    expect(linha.endereco).to eq('RUA B, 2')          # o plano manda no resto
+    expect(resultado.preservados).to eq(1)
+    expect(resultado.atualizados).to eq(1)
+  end
+
+  it 'faz veículo e ordem seguirem o plano mesmo numa linha editada' do
+    importar([linha_do_plano(nf: '1', veiculo: 'GADE_001', ordem: 1)])
+    linha = romaneio.romaneio_linhas.first
+    linha.marcar_editado!('nome')
+    linha.save!
+
+    importar([linha_do_plano(nf: '1', veiculo: 'GADE_009', ordem: 7)])
+
+    expect(linha.reload.veiculo).to eq('GADE_009')
+    expect(linha.ordem).to eq(7)
+  end
+
+  it 'APAGA a parada que saiu do plano sem edição humana' do
+    importar([linha_do_plano(nf: '1'), linha_do_plano(nf: '2', ordem: 2)])
+
+    resultado = importar([linha_do_plano(nf: '1')])
+
+    expect(romaneio.romaneio_linhas.pluck(:nota_fiscal)).to eq(['1'])
+    expect(resultado.saidos).to eq(1)
+  end
+
+  it 'GUARDA (sem apagar) a parada que saiu do plano mas tinha edição' do
+    importar([linha_do_plano(nf: '1'), linha_do_plano(nf: '2', ordem: 2)])
+    editada = romaneio.romaneio_linhas.find_by(nota_fiscal: '2')
+    editada.marcar_editado!('endereco')
+    editada.save!
+
+    importar([linha_do_plano(nf: '1')])
+
+    expect(editada.reload.removido_em).to be_present
+    expect(romaneio.linhas_vigentes.pluck(:nota_fiscal)).to eq(['1'])
+  end
+
+  it 'devolve a parada guardada para a folha quando ela volta ao plano' do
+    importar([linha_do_plano(nf: '1'), linha_do_plano(nf: '2', ordem: 2)])
+    editada = romaneio.romaneio_linhas.find_by(nota_fiscal: '2')
+    editada.marcar_editado!('endereco')
+    editada.save!
+    importar([linha_do_plano(nf: '1')])
+
+    importar([linha_do_plano(nf: '1'), linha_do_plano(nf: '2', ordem: 2)])
+
+    expect(editada.reload.removido_em).to be_nil
+  end
+
+  it 'descarta a NF repetida no plano e reporta, em vez de duplicar a parada' do
+    resultado = importar([linha_do_plano(nf: '1', nome: 'PRIMEIRO'),
+                          linha_do_plano(nf: '1', nome: 'SEGUNDO', ordem: 2)])
+
+    expect(romaneio.romaneio_linhas.count).to eq(1)
+    expect(romaneio.romaneio_linhas.first.nome).to eq('PRIMEIRO')
+    expect(resultado.duplicados).to eq(1)
+  end
+
+  it 'não colide duas paradas sem NF (a chave cai para o digest do título)' do
+    sem_nf = linha_do_plano(nf: '').merge(titulo: 'PONTO DE APOIO')
+    outra  = linha_do_plano(nf: '', endereco: 'RUA Z, 9', ordem: 2).merge(titulo: 'OUTRO PONTO')
+
+    expect { importar([sem_nf, outra]) }.not_to raise_error
+    expect(romaneio.romaneio_linhas.count).to eq(2)
+  end
+
+  it 'apaga a folha do veículo que sumiu do plano' do
+    importar([linha_do_plano(nf: '1'), linha_do_plano(nf: '2', veiculo: 'GADE_002')])
+
+    importar([linha_do_plano(nf: '1')])
+
+    expect(romaneio.romaneio_veiculos.pluck(:veiculo)).to eq(['GADE_001'])
+  end
+end

spec/services/romaneios/plano_planilha_spec.rb

@@ -0,0 +1,102 @@
+require 'rails_helper'
+require 'caxlsx'
+
+# A planilha do plano é o caminho B do romaneio — e é o que o cliente usa quando o
+# plano do dia ainda não está publicado. Os casos aqui são os que o export REAL
+# apresenta (medido em Imagens para implantação/SimpliRoute_Plan_ 2026-08-31.xlsx):
+# coluna "Motorista" vazia, sem "Aparelho", e a NF numa coluna com typo do próprio
+# SimpliRoute ("ID de referêncua").
+RSpec.describe Romaneios::PlanoPlanilha do
+  def planilha(cabecalho, linhas)
+    pacote = Axlsx::Package.new
+    pacote.workbook.add_worksheet(name: 'Plan') do |aba|
+      aba.add_row(cabecalho)
+      linhas.each { |l| aba.add_row(l) }
+    end
+    arquivo = Tempfile.new(['plano', '.xlsx'])
+    arquivo.binmode
+    arquivo.write(pacote.to_stream.read)
+    arquivo.flush
+    arquivo
+  end
+
+  it 'lê o formato real do export (sem Motorista, sem Aparelho, NF com o typo)' do
+    arquivo = planilha(
+      ['Motorista', 'Veículo', 'Índice de rota', 'Ordem de entrega', 'Título', 'Endereço',
+       'ID de referêncua', 'Anotações'],
+      [[nil, 'GADE_038', 1, 1, 'NF 90507 - Cicera Beserra dos Anjos',
+        'Rua Amapola, 206, Jardim Vista Linda, São Paulo, SP, CEP: 05159-100',
+        '90507', 'TEL: (11) 99262-0594']]
+    )
+
+    linha = described_class.new(arquivo).linhas.first
+
+    expect(linha[:veiculo]).to eq('GADE_038')
+    expect(linha[:nota_fiscal]).to eq('90507')
+    expect(linha[:nome]).to eq('CICERA BESERRA DOS ANJOS')
+    expect(linha[:endereco]).to eq('RUA AMAPOLA, 206, JARDIM VISTA LINDA, SÃO PAULO, SP, CEP: 05159-100')
+    expect(linha[:telefones]).to eq('(11) 99262-0594')
+    expect(linha[:motorista]).to eq('')
+  end
+
+  it 'aceita a grafia corrigida da coluna de referência' do
+    arquivo = planilha(['Veículo', 'Título', 'Endereço', 'ID de referência'],
+                       [['GADE_001', 'NF 1 - Fulano', 'Rua A, 1', '1']])
+
+    expect(described_class.new(arquivo).linhas.first[:nota_fiscal]).to eq('1')
+  end
+
+  it 'aceita título fora do padrão "NF n - NOME" sem perder a parada' do
+    arquivo = planilha(['Veículo', 'Título', 'Endereço'],
+                       [['GADE_001', 'PONTO DE APOIO', 'Rua A, 1']])
+
+    linha = described_class.new(arquivo).linhas.first
+    expect(linha[:nota_fiscal]).to eq('')
+    expect(linha[:nome]).to eq('PONTO DE APOIO')
+  end
+
+  it 'tira o sufixo ", Brazil" do endereço e junta vários telefones' do
+    arquivo = planilha(['Veículo', 'Título', 'Endereço', 'Anotações'],
+                       [['GADE_001', 'NF 1 - Fulano', 'Rua A, 1, Bairro, Brazil',
+                         'TEL: (11) 95440-5780 / (11) 99824-8099']])
+
+    linha = described_class.new(arquivo).linhas.first
+    expect(linha[:endereco]).to eq('RUA A, 1, BAIRRO')
+    expect(linha[:telefones]).to eq('(11) 95440-5780 / (11) 99824-8099')
+  end
+
+  it 'renumera a ordem de 1..N dentro de cada veículo, na ordem de entrega do plano' do
+    arquivo = planilha(['Veículo', 'Ordem de entrega', 'Título', 'Endereço'],
+                       [['GADE_001', 3, 'NF 3 - C', 'Rua C'],
+                        ['GADE_002', 9, 'NF 9 - I', 'Rua I'],
+                        ['GADE_001', 1, 'NF 1 - A', 'Rua A']])
+
+    linhas = described_class.new(arquivo).linhas
+    primeiro = linhas.select { |l| l[:veiculo] == 'GADE_001' }
+    expect(primeiro.map { |l| [l[:ordem], l[:nota_fiscal]] }).to eq([[1, '1'], [2, '3']])
+    expect(linhas.find { |l| l[:veiculo] == 'GADE_002' }[:ordem]).to eq(1)
+  end
+
+  it 'pula linha sem veículo (rodapé do próprio export) sem levantar erro' do
+    arquivo = planilha(['Veículo', 'Título', 'Endereço'],
+                       [['GADE_001', 'NF 1 - A', 'Rua A'], [nil, nil, nil]])
+
+    expect(described_class.new(arquivo).linhas.size).to eq(1)
+  end
+
+  it 'recusa arquivo que não é .xlsx com uma mensagem acionável' do
+    arquivo = Tempfile.new(['plano', '.xlsx'])
+    arquivo.write('isto não é um zip')
+    arquivo.flush
+
+    expect { described_class.new(arquivo) }
+      .to raise_error(described_class::Erro, /não é um \.xlsx/)
+  end
+
+  it 'recusa planilha sem a coluna Veículo — não dá para montar folha sem carro' do
+    arquivo = planilha(['Título', 'Endereço'], [['NF 1 - A', 'Rua A']])
+
+    expect { described_class.new(arquivo).linhas }
+      .to raise_error(described_class::Erro, /Veículo/)
+  end
+end